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ABSTRACT 


The  Naval  Postgraduate  School’s  (NPS)  Space  Systems  Academic  Group  (SSAG) 
is  currently  developing  the  Petite  Amateur  Navy  Satellite  (PANSAT).  This  thesis 
describes  the  PANSAT  Software  Groundstation  development  and  design.  This  covers 
requirements  that  led  to  various  design  decisions  as  well  as  the  use  of  the  Groimdstation 
Software  and  the  programming  background  necessary  to  provide  detailed  information  of 
how  to  enhance  this  software  in  the  future.  Furthermore,  it  can  be  considered  as  a  brief 
manual  for  the  development  of  software  other  than  the  Groundstation  with  the  high-level 
programming  language  C-H-. 

The  Groundstation  Software  is  designed  to  run  vmder  Windows  3.x®  or 
Windows  NT®  operating  systems  on  an  IBM-compatible  PC.  It  allows  an  easy  visual 
access  to  all  command  and  control  features  incorporated  in  the  PANSAT  design  via  the 
PANSAT  Command  Language  (PCL).  The  software  design  provides  full  control  over  the 
additional  hardware  necessary  to  physically  establish  a  cormection  to  PANSAT,  by 
plugging  it  into  the  serial  port  of  the  PC  running  the  Software  Groundstation. 

The  data  structures  and  the  visual  controls  are  designed  to  meet  the  requirements 
of  usability,  flexibility  and  compatibility  to  third-party  software.  In  addition,  the  use  of 
data  encapsulation  as  a  typical  feature  of  the  programming  language  C-H-  ensures 
readable  source  code. 
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I.  INTRODUCTION 


A.  THE  PANSAT  PROJECT 

The  PANSAT  project  was  initiated  in  1989  as  an  educational  program  for  student 
officers  at  the  Naval  Postgraduate  School’s  (NPS)  Space  Systems  Academic  Group 
(SSAG).  It  was  intended  to  prepare  postgraduate  students  for  space  related  tasks  as  well 
as  to  develop  a  cadre  of  engineers  capable  of  developing  and  actually  producing  space 
qualified  hardware. 

PANSAT  is  a  small  satellite  for  digital  store-and-forward  communications  in  the 
amateur  frequency  band.  It  features  a  direct  sequence  spread  spectrum  differentially 
coded,  binary  phase  shift  keyed  (BPSK)  communication  system  at  an  operating  frequency 
of  436.5MHz.  This  adds  a  new  dimension  to  amateur  radio  communication,  as  spread 
spectrum  capability  has  never  been  used  before  in  that  context.  The  store-and-forward 
capability  will  allow  amateur  radio  operators  to  send  or  receive  messages  during  several 
short  communication  windows  every  day,  each  6  to  10  minutes  of  length, 

The  whole  PANSAT  structure  weighs  approximately  150  pounds,  has  a  diameter 
of  about  19  inches,  and  is  being  designed  to  launch  as  a  secondary  payload  from  the 
Space  Shuttle  as  part  of  the  Hitchhiker  Program.  It  is  made  of  aluminium  6061-T6  and 
built  around  a  main  load  bearing  cylinder  connected  to  the  lower  equipment  plate;  a  26- 
sided  polyhedron  was  the  chosen  configuration  to  maximize  solar  panel  area  and  thus 
power  generation.  PANSAT  will  be  unstabilized  and  tumble  freely,  once  put  into  space 
with  a  Get  Away  Special  (GAS)  container.  Its  operational  life  is  expected  to  be  two  years 
at  an  inclination  between  28.5°  and  51.6°  and  an  altitude  between  160  and  220  nautical 
miles. 
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B.  THE  PANSAT  GROUNDSTATION 


Once  PANSAT  is  in  space,  the  only  means  to  access  it  is  via  radio  control.  This 
shall  include  both  commanding  and  gathering  telemetry.  Because  PANSAT’ s  hardware 
capabilities  require  commanding  structure  of  a  relatively  high  complexity,  the  problem  of 
dealing  with  the  correct  sequence  of  all  possible  commands,  their  correct  timing  as  well 
as  telemetry  storage  and  -maintenance  becomes  apparent.  The  most  convenient  way  for 
PANSAT  users  would  then  require  some  kind  of  maintenance  tool  or,  in  terms  of  space 
technology,  groundstation  which  would  encapsulate  this  functionality  in  one  entity. 

Most  commonly,  satellite  groundstations  consist  of  three  parts  (Figure  1):  one  or 
more  computers,  the  necessary  additional  hardware  for  radio  commimications,  and  the 
software  serving  as  a  connection  between  those  two  parts.  The  software  part  of  such  a 
satellite  groimdstation  is  the  scope  of  this  thesis. 


Figure  1:  Parts  of  a  Satellite  Groundstation  and  Satellite: 
A  PC  (1),  the  addditional  hardware  for  radio 
communication  (2),  the  Groundstation  Software  (3)  and  the 
satellite  to  communicate  to  (4). 
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The  term  Software  Groundstation  will  be  used  in  the  following,  referring  to  the 
software  part  of  a  satellite  groundstation.  This  is  done  to  indicate  that  the  software  is  a 
major  and  separable  part  of  the  whole  groundstation  concept,  and  to  distinguish  it  from 
the  hardware  part. 

The  Software  Groundstation  is  the  only  interface  between  users  on  earth  and  the 
spacecraft.  As  with  most  of  all  user  interfaces,  they  should  be  adapted  to  human  needs 
rather  than  human  beings  to  user  interfaces.  Because  many  technical  vehicles  (such  as 
satellites)  are  becoming  more  complex  as  they  are  becoming  more  powerful,  the  design  of 
a  satellite-to-human  software  interface  likewise  is  more  important.  Whenever  human 
interaction  is  needed  for  such  vehicles,  user  friendliness  should  be  a  major  concern 
before,  while,  and  after  the  development  phase  of  the  software  user  interface.  A  user 
friendly  design  does  not  only  make  working  with  this  interface  more  convenient,  but  also 
increases  security  and  performance. 

C.  OVERVIEW 

The  following  four  chapters  “Groimdstation  Requirements”,  “Groundstation 
User’s  Manual”,  “Development  Preparation  Manual”  and  “Programmer’s  Reference” 
present  the  reader  with  a  climax  in  detailed  description.  The  first  two  chapters  explain 
necessary  background  information  for  users  of  the  groimdstation,  whereas  the  last  two 
chapters  prepare  a  software  developer  to  cope  with  the  problem  of  enhancing  the 
groundstation  software. 

For  reference  purposes,  the  current  source  code  of  the  groundstation  is  provided  in 
the  Appendix. 
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II.  GROUNDSTATION  REQUIREMENTS 


This  chapter  provides  the  information  which  finally  led  to  the  multiple  decisions 
concerning  the  development  and  design  of  a  suitable  PANSAT  Software  Groundstation. 
The  first  section  explains  the  need  for  a  computer  based  (software)  groundstation.  The 
second  section  discusses  the  more  detailed  aspects  of  the  groundstation  based  on  those 
decisions.  Finally,  the  third  section  allows  a  closer  inspection  on  the  facts  that  led  to  the 
decisions  made  concerning  the  software  development  environment  of  the  PANSAT 
Groundstation. 

A.  THE  GROUNDSTATION  AS  A  COMPUTER  SOFTWARE 


easy 

access  all 

to 

PANSAT 

use 

functionality 

inexpensive 

J 

.V  7  V, 


PANSAT 

Software 

Groundstation 


easily 

reproducable 


widespread 
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Figure  2:  Advantages  of  a  Software  Groundstation 

Programming  a  computer  requires  detailed  knowledge  of  the  development  tools, 
including  a  programming  language  as  well  as  the  programming  and  hardware 
environment.  The  lack  of  this  knowledge  often  prevents  one  from  the  use  of  up-to-date 
software  tools  and  computers;  even  though  a  software  implementation  in  such  an 
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environment  would  be  most  advantageous.  The  advantages  of  a  Software  Groundstation 
instead  of  other  non  software-based  solution  become  apparent  when  just  enumerating  the 
advantages  of  software  in  general: 


•  Software  is  flexible  by  definition:  it  is  designed  to  be  changed  and  adapted  to  a  large 
variety  of  tasks.  Whatever  is  imaginable  to  do  with  a  specific  hardware  (computer, 
additional  hardware)  could  be  done  by  programming  it. 

•  Once  a  basic  knowledge  about  programming  is  established,  software  development  can 
go  on  relatively  fast  and  cheap.  Besides  a  standard  PC  and  the  development  package, 
there  is  hardly  any  need  for  cost-intensive  additional  products.  However, 
sophisticated  software  tools  can  be  very  expensive,  and  the  time  spent  learning  to 
program  is  a  cost  factor  too.  But  normally  the  benefits  of  a  software  implementation 
will  be  worth  the  money  and  time  spent  for  it,  and  sometimes  there  is  not  an 
alternative. 

•  The  flexibility  of  software  applications  gives  the  opportunity  to  program  them  user 
friendly,  especially  with  a  graphical  oriented  operating  system  such  as  Windows  or 
Windows  NT. 

•  Use  of  a  PC  as  a  runtime  platform  ensures  widespread  use  of  the  software  that  can  run 
on  it,  thus  making  it  attractive  to  all  people  who  want  to  solve  a  specific  problem  with 
this  software.  Also,  many  people  own  a  PC. 
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B.  SOFTWARE  AND  DEVELOPMENT  CONSTRAINTS 


Figure  3:  Software  and  Development  Environment  Constraints  Leading  to 
the  Design  of  the  PANSAT  Software  Groundstation 

The  software  tools  to  be  used  when  programming  the  PANSAT  Software 
Groundstation  were  imdetermined  in  the  beginning.  However,  some  of  the  requirements 
forced  a  decision: 


6 


•  Existing  software  such  as  the  operating  system  intended  to  be  used  onboard  PANS  AT 
was  already  available.  It  was  written  in  C,  so  the  programming  language  used  for  the 
Software  Groundstation  should  be  C  (or  C++,  which  incorporates  C)  also.  However, 
this  was  not  a  must. 

•  The  programming  language  should  be  high-level  and  structurized,  and  it  should  be 
common  for  multipurpose  tasks.  Furthermore,  it  should  allow  a  GUI  method  for  user 
interaction;  that  is,  a  huge  choice  of  visual  controls.  These  constraints  limited  the 
amount  of  suitable  languages  to  Object  Pascal  (as  used  in  Borland’s  Delphi)  and 
C++  (as  used  in  Microsoft  Visual  C++  and  Borland  C++).  Delphi  offered  a  large 
variety  of  visual  controls,  whereas  the  C++  compilers  stuck  to  somewhat  standard 
controls.  But  because  of  the  proven  performance  and  the  long  period  of  presence  on 
the  market,  C++  was  chosen. 

•  The  operating  system  used  for  development  should  be  the  same  for  the  runtime 
application  version.  This  ensures  data  structure  integrity  and  allows  visual  design  for 
the  application  GUI.  It  also  minimizes  software  incompatibility.  The  best  and/or  most 
commonly  used  operating  systems  enabling  GUI  programming  are  the  Macintosh 
Finder  and  Microsoft  Windows  3.x  or  Windows  NT.  Because  of  the  common  market 
acceptance  for  Windows  as  well  as  being  the  most  common  platform  within  the 
SSAG,  this  operating  system  was  chosen. 

•  The  hardware  development  platform  should  normally  be  the  same  platform  as  for 
running  an  application  (in  contrary  to  cross-platform  development).  This  ensures 
hardware  compatibility  and  minimizes  software  incompatibility  between  development 
and  runtime  application  versions.  Furthermore,  a  PC-based  platform  would  be 
recommendable  because  of  the  widespread  use  of  Intel®-80x86  processor  series 
based  computers. 

The  first  steps  in  designing  a  Software  Groundstation  were  done  in  accordance  to 
[Ref.  15,  chapter  IX.  Ground  Station  Software  Design).  This  description,  however, 
involved  too  little  detail  to  be  useful  for  the  actual  design.  In  addition,  the  PANSAT 
Command  Language  (PCL)  [Ref.  16]  was  subject  to  development  after  [Ref  15]  was 
written,  and  development  software  tools  increased  their  capabilities  during  that  time.  So  it 
turned  out  that  almost  none  of  the  information  in  [Ref  15]  were  suitable  for  the  PANSAT 
Software  Groundstation. 
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C.  THE  DEVELOPMENT  ENVERONMENT 


For  the  development  of  the  PANSAT  Software  Groundstation  (furthermore 
referred  to  as  “groundstation”)  several  aspects  have  been  taken  into  consideration.  First, 
the  groimdstation  should  be  a  PC-based  application  using  the  Windows  or  Windows  NT 
graphical  user  interface  (GUI).  Second,  it  should  be  written  in  a  language  familiar  to  the 
Space  Systems  Academic  Group,  so  that  it  could  be  changed  or  enhanced  once  the  core 
has  been  programmed.  Third,  this  language  should  allow  compatible  access  to  the  third- 
party  developments,  such  as  SCOS^ . 

The  choice  was  quite  easy:  the  programming  language  should  be  C  or  C-H-.  This 
decision  determined  the  compiler:  Microsoft  Visual  C++  Compiler  (furthermore  referred 
to  as  “MSVC”).  There  were  other  C++  compilers  on  the  market,  but  as  the  author  was 
familiar  with  this  specific  one,  MSVC  was  chosen.  The  new  version  of  MSVC  runs  only 
imder  Windows  NT;  thus,  the  development  platform  was  determined. 

The  GUI  specifications  for  the  groundstation  needed  a  riiore  advanced  design  than 
MSVC  was  capable  to  offer  in  the  first  place.  However,  MSVC’s  capabilities  could  be 
enhanced  by  an  additional  interface  programming  package.  WinWidgets/32  (WW)  was 
chosen,  especially  because  of  its  so-called  “tabbed  dialog”  feature  (a  GUI  feature  which 
simplifies  the  display  of  multiple  dialogs).  In  order  to  make  MSVC  work  with  WW, 
another  dialog  editor  had  to  be  purchased:  Borland’s  Resource  Workshop  (RW).  The 
MSVC  built-in  AppStudio  dialog  editor  does  not  feature  the  ability  to  graphically 
manipulate  a  GUI  in  connection  v^dth  WW,  wheras  RW  offered  this  possibility. 


'  SCOS:  Spacecraft  Operating  System;  the  operating  system  used  for  PANSAT 
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III.  GROUNDSTATION  USER’S  MANUAL 


This  manual  describes  how  the  PANSAT  Software  Groundstation  actually  works. 
It  consists  of  nine  subsections,  each  representing  one  dialog  of  the  groundstation  which 
automatically  appears  when  you  start  the  application.  Each  of  those  dialogs  represents 
one  part  of  the  PANSAT  Command  Language  (PCL)  with  similar  functionality.  All  eight 
dialogs  (and  a  remaining  embedding  parent  dialog)  offer  full  access  to  all  commands 
available  with  PCL.  Finally,  a  short  description  of  some  auxiliary  dialogs  is  presented. 

This  manual  assumes  that  you  are  already  familiar  with  using  a  graphical  oriented 
operating  system  such  as  Windows  or  Windows  NT. 

A.  THE  “SCRIPTS”  DIALOG 
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Figure  4:  The  Scripts  Dialog 


9 


Within  this  Scripts  dialog  (Figure  4),  the  user  is  able  to  load,  write,  create  and 
edit  scripts  and  macros.  Both  may  consist  of  one  or  more  commands.  A  command  is 
every  order  you  give  either  to  PANSAT  or  the  Groundstation  Software.  A  macro  is  one 
or  more  subsequent  commands  which  are  intended  to  be  sent  to  PANSAT,  that  is,  one  or 
more  command  which  is  part  of  the  PANSAT  Command  Language  PCL.  A  script  is  one 
or  more  subsequent  commands;  this  includes  both  PCL  and  language  items  not  intended 
to  be  sent  to  PANSAT,  but  to  control  the  Groundstation  Software  itself  Refer  to  Figure  4 
for  a  description  of  the  features  of  this  dialog: 


1.  This  Listbox  represents  the  current  Macro.  It  contains  all  commands  in  the  execution 
sequence.  All  new  commands  are  inserted  before  the  highlighted  command 
(drop_users  in  this  case).  When  highlighted,  the  (next)  entry  allows  insertion  at 
the  end  of  the  Macro. 

2.  This  Listbox  shows  all  available  PCL  commands,  or,  in  case  of  Script  editing  (5), 
all  available  commands. 

3.  These  two  Editfields  show  the  command  (left,  drop_users  in  this  case)  and  its 
parameters,  if  applicable  (right,  void  in  this  case).  The  Erase  Edit  Line  Button 
on  the  far  right  clears  both  Editfields.  If  a  command  takes  parameters,  a  click  in  the 
right  Editfield  causes  the  specific  dialog  to  appear  in  which  the  parameters  of  the 
command  (left  Editfield)  can  be  edited.  This  will  be  one  of  the  following  dialogs: 
Mail,  Memory,  Low-Level,  High-Level,  Files  or  Task  dialog.  They  are  put  into 
a  special  mode  which  allows  only  for  setting  or  editing  parameters  of  the  command  in 
the  left  Editfield. 

4.  These  two  Radiobuttons  determine  the  edit  mode.  They  change  the  reaction  on  mouse 
clicks  in  area  1  and  2.  The  four  buttons  in  area  6  indicate  which  mouse  click  produces 
which  reaction,  that  is,  left  or  right  mousebutton.  Refer  to  area  6  for  explanation. 

5.  These  two  Radiobuttons  determine  whether  all  commands  are  to  be  shown  in  areas  1, 
2  and  3  (Script) ,  or  only  PCL  commands  are  to  be  shown  (Macro). 

6.  These  four  Pushbuttons  allow  Macro  editing.  Insert  from  Edit  Line  inserts  the 
contents  of  3  before  the  highlighted  command  listed  in  1.  Cut  to  Edit  Line 
deletes  the  highlighted  command  line  in  1  and  pastes  it  into  3.  insert  pastes  the 
highlighted  command  of  2  in  both  1  and  3,  but  only  in  case  the  command  does  not 
require  parameters.  However,  if  it  requires  parameters,  the  highlighted  command  in  2 
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is  pasted  only  in  3.  By  pressing  Edit,  the  highlighted  command  in  2  is  pasted  only  to 
3,  regardless  of  its  parameter  requirements.  In  Express  Editing  mode,  the 
position  of  the  Pushbuttons  below  the  Listboxes  1  and  2  indicates  which  mousebutton 
(left  or  right)  has  to  be  clicked  in  1  or  2  to  obtain  the  same  reaction  as  when  clicking 
on  one  of  the  Pushbuttons.  For  example,  click  left  in  1  to  Insert  from  Edit 
Line,  click  right  in  1  to  Cut  to  Edit  Line.  Same  with  2:  click  left  in  2  to 
Insert,  or  click  right  in  2  to  Edit. 

7.  These  five  Pushbuttons  allow  loading,  saving  and  creating  Macros  as  well  as  deleting 
Macros  from  disk.  If  a  Macro  has  been  changed,  the  user  is  prompted  to  save  or  save 
as  it  (depending  on  whether  or  whether  not  it  already  has  a  filename)  before 
continuing  with  other  actions.  Furthermore,  the  default  directory  setting  is 
automatically  updated  according  to  the  Radiobutton  setting  5.  Scripts  and  Macros  are 
stored  in  different  directories  as  defined  in  the  Preferences  dialog  (Figure  13),  or 
as  the  appropriate  section  in  the  .  ini  file  tells. 

B.  THE  “TELEMETRY”  DIALOG 


This  dialog  presents  the  current  telemetry  data  received  from  PANSAT.  It  is  not 
yet  defined  whether  all  available  telemetry  should  be  shown,  or  just  parts  of  it. 
Furthermore,  the  storage  format  is  not  implemented  yet;  all  telemetry  shall  be  stored  in  an 
ODBC-compatible  format.  This  implementation  might  alter  the  decision  which  part  of  the 
telemetry  shall  be  presented  in  this  dialog.  In  addition,  the  return  structure  (the 
SReturnCmd  structure)  is  not  implemented  yet  either.  This  task  should  be  accomplished 
after  the  evaluation  of  the  input  stractures.  Therefore,  the  outward  appearance  of  this 
dialog  is  postponed  after  the  necessary  preliminary  actions  are  taken. 

The  Preferences  dialog  (Figure  13)  contains  information  about  the  location  of 
telemetry  data  on  a  groundstation  mass  storage  device.  Telemetry  data  will  be  stored  in 
this  directory. 
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C.  THE  “MAIL”  DIALOG 


The  Mail  dialog  handles  the  PANS  AT  mail  capability.  Mail  could  be  regarded  as 
a  message  with  additional  information:  a  from  and  to  designator,  the  time  the  mail  was 
sent,  a  subject  and  the  text  of  the  ASCII-message  to  be  included  in  the  mail.  This  dialog 
now  offers  the  possibility  to  load,  create  and  edit  a  message,  and  send  it  to  PANSAT;  to 
retrieve  an  already  stored  mail  from  PANSAT’ s  memory,  read  the  message  and  the 
additional  information,  and  save  it  to  disk.  The  following  visual  controls  allow  mail 
handling  (refer  to  Figure  5): 


1.  This  Listbox  shows  the  current  status  of  the  PANSAT  Mail  Directory,  as  stored  in 
recent  telemetry.  It  contains  the  names  of  the  mail  files.  Select  a  mail  by  highlighting 
its  name  with  a  mouse  click. 

2.  This  Listbox  shows  the  ASCII  message  of  the  mail.  Carriage  return  is  inserted 
automatically. 
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3.  This  Editfield  shows  the  file  name  of  the  current  mail. 


4.  These  four  Editfields  contain  additional  mail  information,  very  similar  to  email.  The 
From  and  To  designator  determine  the  sender  and  the  recipient  of  the  mail,  the  Date 
determines  the  time  (day/month/year  hourminute)  of  sending,  and  the  Subject  line 
should  give  an  idea  of  what  to  expect  from  the  message  (as  shown  in  2). 

5.  These  five  Pushbuttons  trigger  the  PANSAT  mail  input/output.  Get  Mail  retrieves 
the  mail  currently  highlighted  in  1  and  shows  it  by  filling  up  2,  3  and  4. 
Get  Directory  updates  the  entries  in  1  by  retrieving  the  current  mail  directory 
from  PANSAT.  Delete  Mail  deletes  the  current  selection  in  1  by  deleting  the  mail 
inside  PANSAT,  and  Purge  All  Mail  deletes  all  mail  inside  PANSAT.  A 
Get  Directory  afterwards  should  reflect  these  actions.  The  Add  Mail  button  lets 
the  user  edit  his  own  mail  in  2,  3  and  4.  The  button  then  changes  to  Send  Mail. 
When  done,  the  user  presses  the  Send  Mail  button,  and  the  mail  is  uplinked  to 
PANSAT. 
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D.  THE  “MEMORY”  DIALOG 


Figure  6:  The  Memory  Dialog 


The  Memory  dialog  allows  access  to  the  various  kinds  of  memories  inside 
PANSAT.  This  is  a  very  powerful  feature,  because  every  byte  of  PANSAT’s  memory  can 
be  altered.  The  dialog  is  intended  to  serve  as  an  emergency  repair  possibility  only.  By 
using  the  features  of  this  dialog,  the  user  must  be  aware  of  the  fact  that  he  could  endanger 
the  electronic  life  of  PANSAT. 

The  dialog  consists  of  several  parts  (refer  to  Figure  6): 

1.  This  Grid  contains  256  bytes  of  memory  data  in  16  rows.  The  first  column  Address 
shows  the  address  of  the  memory  contents  as  used  in  PANSAT.  The  second  column 
Hex  Data  presents  the  memory  data  in  hex  format,  16  bytes  per  row,  separated  by 
whitespaces.  The  third  column  ASCII  Data  shows  the  same  16  bytes  as  in 
Hex  Data  in  ASCII  format.  The  user  may  edit  entries  in  Hex  Data  and 
ASCII  Data  columns.  However,  altered  data  changes  its  color  from  black  to  red,  but 
is  not  yet  uplinked  to  PANSAT.  The  Scrollbar  on  the  right  side  allows  sequential 
reading  of  PANSAT’s  memory  contents;  one  click  on  the  up  or  dovm  arrow  reads  16 
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bytes,  one  click  above  or  below  the  slider  reads  256  bytes.  Dragging  the  slider  with 
the  mouse  allows  placing  it  to  the  desired  memory  range.  In  this  case,  the  Address 
column  contents  change  as  the  slider  is  dragged  and  shows  the  current  256-byte 
address  block,  but  a  256  byte  memory  block  is  read  from  PANSAT  only  when  the 
slider  is  released  from  dragging. 

2.  These  two  Radiobuttons  determine  the  display  mode  of  the  Address  column 
contents  in  Grid  1;  either  20-Bit  or  SegmentrOffset  address  display. 

3.  These  four  Radiobuttons  determine  the  memory  which  is  shown  in  Grid  1:  RAM, 
SRAM,  ROM  or  FLASH  memory.  ROM  cannot  be  edited. 

4.  With  these  six  Pushbuttons,  the  user  can  define  which  part  of  memory  is  to  be 
accessed:  memory  in  Mass  Storage  A  or  B,  Analog  Multiplexer  A  or  B,  the  electric 
power  supply  (EPS)  or  the  communications  unit  (RF  System).  In  Figure  6,  the 
Mass  A  (Mass  Storage  A)  button  is  selected. 

5.  With  these  two  Pushbuttons,  the  user  can  determine  whether  to  allow  memory  editing 
(Edit)  or  deny  it  (view).  When  denied  (view),  editing  in  Grid  1  becomes 
impossible. 

6.  These  two  Editfields  and  two  Pushbuttons  reflect  the  current  memory  edit  status  of 
the  memory  block  subject  to  editing^ .  In  the  Bytes  modified  Editfield  the  amount 
of  edited  (red),  but  not  yet  uplinked  data  bytes  is  shown.  The  Bytes  written 
Editfield  shows  the  amount  of  edited  bytes  already  written  to  PANSAT.  The  Cancel 
button  abandons  all  changes  to  the  memory  block  subject  to  editing  and  reverts  its 
data  bytes  to  the  previous  values.  Thus,  the  Bytes  modified  entry  becomes  zero, 
and  all  red  data  in  Grid  1  changes  its  value  to  the  previous  setting  and  becomes  black. 
The  Reset  button  sets  the  Bytes  written  entry  to  zero,  but  does  not  do  an5dhing 
else  to  memory  data. 

7.  These  two  buttons  are  the  only  ones  which  establish  PANSAT  I/O  besides  the 
Scrollbar  in  Grid  1.  The  Write  Modified  Bytes  button  writes  all  edited  bytes 
shown  red  in  Grid  1  as  well  as  all  edited  bytes  not  in  the  current  display  of  Grid  1  to 
the  appropriate  address  and  storage  (as  depicted  in  1,  3  and  4)  onboard  PANSAT.  The 
Re-Read  Visible  Block  button  reads  the  256  bytes  currently  visible  in  Grid  1 
from  PANSAT  and  displays  it.  Any  changes  to  the  visible  part  of  memory  are 
abandoned  by  this  actionj  thus,  every  edited  (red)  entry  is  updated  with  the  current 


^  The  memory  data  display  is  limited  to  256  bytes  in  Grid  1,  but  the  editable  range  can  be  much 
bigger  (using  the  Scrollbar  in  Grid  1).  The  memory  edit  status  as  referred  to  in  6  includes  all  edited  bytes 
(even  if  they  are  not  visible  in  Grid  1)  since  the  beginning  of  the  edit  session  or  the  last  uplink  to  PANSAT. 
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PANSAT  memory  contents  and  is  shown  in  black,  and  the  Bytes  modified  entry 
(6)  is  adjusted  appropriately.  This  function  is  particularly  useful  when  monitoring 
frequently  changing  memory  contents. 

E.  THE  “LOW-LEVEL”  DIALOG 
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The  Low-Level  dialog  handles  a  multitude  of  settings  onboard  PANSAT  which 
relate  to  close-to-hardware  components  control.  The  dialog  is  designed  to  provide  a 
system  overlook;  thus  it  contains  more  visual  controls  than  other  dialogs.  It  falls  into 
several  parts  (Figure  7): 


1.  The  Power  Switches  frame  contains  On-Off  switches  for  multiple  hardware 
sections  onboard  PANSAT:  the  communications  unit  (rf),  the  multiplexing  units  A 
and  B  (mux  a,  mux  b),  and  the  mass  storage  devices  A  and  B  (MStor  A,  MStor  b). 
On  means,  the  unit  is  provided  with  current.  Off  means,  no  current  available  for  the 
unit. 


Figure  7:  The  Low-Level  Dialog 
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2.  The  RF  System  frame  falls  into  four  parts:  Receiver,  Transmitter, 
Power  Level  and  Transmit  Mode.  The  Receiver  and  Transmitter  Mixer 
settings  are  interdependent:  when  using  Mix  #5  for  one  of  them,  it  is  desirable  that 
the  other  also  uses  Mix  #5,  and  the  same  with  Mix  #6.  However,  it  might  turn  out  to 
be  necessary  to  have  different  Mixer  switches  for  receiving  and  transmitting.  The  first 
choice  would  be  to  use  Mix  #5  and  lna  #1  for  the  receiver,  and  Mix  #5  and 
HPA  #3  for  the  transmitter.  The  receiver  may  use  either  low  noise  amplifier  (lna  #l 
or  LNA  #2),  and  the  transmitter  may  use  either  high  power  amplifier  (HPA  #3  or 
HPA  #4).  The  numbering  refers  to  bits  in  the  control  byte  determining  the  receiver 
and  transmitter  settings.  The  Power  Level  Spin  Control  allows  for  settings  in  the 
range  from  0  to  255  dB;  however,  the  exact  attenuation  level  is  not  determined  yet. 
The  Transmit  Mode  subframe  allows  for  Spread  Spectrtim  or  No  Spread 
Spectrum;  settings  for  Narrow  Band  transmission  and  Binary  Phased  Shift  Keying 
(BPSK)  are  set  automatically. 

3.  The  Batteries  frame  contains  settings  for  both  batteries,  A  and  B.  The  possible 
settings  are  Charge,  Discharge  and  Online.  During  system  start,  it  is  possible 
(though  not  desirable)  to  have  the  batteries  in  none  of  those  three  modes.  There  are 
several  combinations  which  are  not  possible:  for  each  battery,  it  is  prohibited  to  to 
Charge  and  be  Online,  or  Discharge  and  be  Online,  or  to  Charge  and 
Discharge,  or  to  Charge  and  Discharge  and  be  Online.  Furthermore,  it  is  not 
allowed  that  both  batteries  Charge  at  the  same  time,  or  that  one  battery  Charges  the 
same  time  the  other  battery  is  Online. 

4.  The  Temperature  MUX  (Multiplexer)  switch  is  not  determined  yet. 

5.  The  Watchdog  Radiobuttons  and  Pushbuttons  control  the  Digital  Control  System 
(DCS  #1  or  DCS  #2).  Each  chosen  DCS  watchdog  can  be  halted  by  pressing  Stop, 
and  it  ean  be  reset  by  pressing  Reset. 

6.  Each  Digital  Control  System’s  ROM  can  be  rebooted  by  pressing  the  ROM  Boot 
button. 

7.  The  SCOS  Parameters  frame  allows  for  Read  and  Update 

Spacecraft  derating  System’s  Parameters.  It  is  not  yet  defined  how  data  transfer 
should  be  aceomplished  for  this  task. 

8.  The  PANSAT  Clock  frame  contains  an  Editfield  showing  the  current  PANSAT 
system  clock.  In  case  it  differs  from  ground  time,  the  user  may  click  the  Set  button  to 
adjust  PANSAT’ s  system  clock  to  the  Software  Groundstation  time.  This  should  only 
be  done  direetly  after  reading  PANSAT’s  system  time  via  the  Read  button,  because 
the  time  display  is  not  updated  automatically. 
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9.  The  Peripheral  Control  Bus  (PCB)  onboard  PANSAT  can  be  initialized  inside  the 
Peripheral  Control  Bus  frame.  This  will  reset  it  to  a  defined  startup  status. 


F.  THE  “HIGH-LEVEL”  DIALOG 


Figure  8:  The  High-Level  Dialog 


The  Software  Groundstation’s  High-Level  dialog  (Figure  8)  handles 
PANSAT’ s  Event  Log  and  Time  Tagged  Commands  feature.  An  Event  Log  is  a  list  of 
time  associated  with  an  already  executed  command;  Time  Tagged  Commanding  allows 
remote  command  execution  by  associating  a  command  to  a  certain  time  at  which  the 
command  shall  be  executed.  Thus,  both  lists  contain  the  same  time-to-command 
association.  The  Event  Log  is  a  report  of  what  already  happened,  whereas  the  Time 
Tagged  Command  list  holds  commands  for  future  execution.  The  following  visual 
controls  allow  Event  Log  and  Time  Tagged  Command  handling: 
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1 .  This  Grid  contains  PANSAT’s  ciirrent  Event  Log.  The  list  may  display  up  to  12  time- 
to-command  associations.  The  Time  column  contains  the  time  in 
hours:minutes:seconds  of  PANSAT  time  and  shows  at  which  time  the  command 
depicted  in  the  same  row  under  the  Command  Executed  column  has  been  executed. 

2.  This  Grid  holds  all  currently  activated  Time  Tagged  Commands.  It  is  built  up  similar 
to  Grid  1 . 

3.  The  Start  Editfield  contains  the  exact  time  and  date  the  current  Event  Log  has 
started.  This  time  is  given  in  hours:minutes:seconds  day,  month,  year  format. 

4.  These  three  Radiobuttons  determine  what  status  PANSAT  is  set  to  as  far  as  user 
access  is  concerned.  Drop&Lockout  executes  the  appropriate  PCL  commands  and 
ceases  eventual  foreign  user  access  and  prevents  new  foreign  users  from  logging  into 
PANSAT.  Lockout  just  prevents  foreign  users  from  logging  on,  and  Unlock  finally 
allows  them  to  again  log  into  PANSAT. 

5.  The  two  Pushbuttons  below  Grid  1  refer  to  PANSAT’s  Event  Log.  Read  retrieves  the 
current  Event  Log.  Purge  All  deletes  it  from  PANSAT’s  memory,  clears  all  Grid  1 
entries  and  resets  the  Start  Editfield. 

6.  These  four  Pushbuttons  below  Grid  2  handle  Time  Tagged  Commanding  (TTC).  The 
Add. . .  button  adds  a  PCL  command  to  the  list.  It  invokes  the  Scripts  dialog  and 
puts  it  into  a  special  mode  so  that  only  one  PCL  command  (and  its  parameters,  if 
applicable)  may  be  selected.  Then  the  command  is  pasted  into  Grid  2,  where  the  user 
has  to  define  the  time  he  wishes  the  command  to  be  executed.  This  time-to-command 
association  then  is  sorted  into  Grid  2  (by  time  criterion).  The  Delete  button  erases 
the  highlighted  time-to-command  association  from  PANSAT’s  TTC  list.  The  List 
button  retrieves  the  currently  activated  list  of  PANSAT’s  TTC.  The  Purge  All 
button  finally  erases  all  currently  activated  entries  from  PANSAT’s  TTC  list. 
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G.  THE  “FILES”  DIALOG 


The  Files  dialog  enables  the  user  to  access  all  file  related  functionality  via  PCL. 
A  file  is  every  portion  of  data  associated  with  a  filename  by  SCOS,  and  stored  in  SCOS- 
accessible  memory.  Mail,  for  example,  is  stored  as  a  file.  The  following  Files  dialog 
items  shall  be  implemented: 


1.  This  Listbox  contains  the  current  PANSAT  filename  list  as  known  in  recent 
telemetry. 

2.  In  this  Listbox,  the  contents  of  the  file  named  as  shown  in  Editfield  3  is  displayed. 

3.  This  Combobox  under  the  Selected  File  (s)  :  Static  Display  contains  a  list  of  all 
recently  read  files.  These  files  may  be  stored  in  the  location  identified  by  the  in 
section  of  the  Preferences  dialog  (Figure  13),  or  the  appropriate  entry  in  the 
GND .  INI  file. 

4.  These  five  buttons  enable  file  reading,  deleting  and  writing  from  and  to  PANSAT. 
Read  File  reads  the  highlighted  file  as  depicted  in  1  and  displays  its  contents  and 
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name  in  2  and  3.  Read  Directory  retrieves  PANSAT’s  current  file  directory  and 
places  this  list  in  1.  Delete  File  erases  the  highlighted  filename  entry  fi-om 
PANSAT’s  file  directory,  and  Purge  All  Files  erases  the  entire  filename  list  from 
PANSAT’s  file  directory.  Write  File  finally  writes  a  file  to  PANSAT’s  mass 
storage  device  and  creates  an  entry  in  PANSAT’s  file  directory.  This  file  shall  be 
loaded  from  a  groundstation  storage  device  to  2,  fi-om  where  it  could  be  uplinked  via 
Write  File.  The  appropriate  buttons  for  loading  a  file  from  a  groundstation  storage 
device  are  not  implemented  yet.  The  files  intended  to  uplink  to  PANSAT  could  be 
stored  in  the  location  identified  by  the  OUT  section  of  the  Preferences  dialog 
(Figure  13),  or  the  appropriate  entry  in  the  OiD .  INI  file. 


H.  THE  “TASK”  DIALOG 


Figure  10:  The  Tasks  Dialog 


The  Tasks  dialog  as  depicted  in  Figure  10  enables  the  user  to  perform  task 
handling.  A  task  is  a  PANSAT  executable  which  is  added  to  the  SCOS-maintained  task 
list.  With  SCOS,  a  Priority-based  Round  Robin  task  scheduling  method  is  used.  The 
following  visual  control  reflect  this  functionality: 
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1.  This  Grid  contains  task  information  for  tasks  currently  recognized  by  SCOS.  Five 
colums  provide  the  necessary  task  information.  The  first  column  contains  Checkboxes 
showing  an  activated  (crossed)  or  deactivated  (not  crossed)  status.  The  second  column 
Task  displays  the  task  name;  the  third,  Status,  the  current  task  status:  running 
waiting,  and  screech.  Refer  to  [Ref  17]  for  further  information.  The  fourth  column 
Pri  shows  the  task  priority  in  four  possible  levels:  0  is  highest,  3  is  lowest  ([Ref  17, 
page  1 1]).  The  fifth  and  last  column,  size,  depicts  the  length  of  the  task  in  bytes.  It 
may  be  as  long  as  2*^  -1=  65535  bytes.  Only  the  first  column  (activation  status)  and 
the  Pri  column  allow  for  user  editing. 

2.  This  Grid  contains  all  files  stored  in  the  location  referenced  by  the  Task  List 
section  of  the  Preferences  dialog  (Figure  13).  The  Software  Groundstation 
considers  all  files  in  this  directory  as  valid  PANSAT  executables.  Filename  and  file 
size  are  shown  in  the  appropriate  columns. 

3 .  This  Editfield  contains  the  name  of  the  highlighted  task  fi-om  Grid  2. 

4.  These  three  Radiobuttons  determine  what  action  is  executed  when  pressin  the  Add 
button  5.  Add  &  Start  Task  &  Get  List  lets  the  Add  button  perform  all  these 
three  actions;  the  Add  &  Get  List  and  Add  Radiobuttons  let  the  Add  button 
perform  actions  respectively. 

5.  The  Add  Pushbutton  uplinks  the  task  with  the  taskname  as  shown  in  3  to  PANSAT’s 
Task  List.  Depending  on  the  settings  in  4,  this  button  behaves  different.  When 
Add  &  Start  Task  &  Get  List  is  activated,  a  click  on  the  Add  button  is  the 
same  as  adding  a  new  task  to  PANSAT’s  task  list,  clicking  its  activation  checkbox  in 
1  and  pressing  the  Get  Tasklist  button.  When  Add  &  Get  List  is  activated,  a 
click  on  the  Add  button  is  the  same  as  adding  a  new  task  to  PANSAT’s  task  list  and 
pressing  the  Get  Tasklist  button.  If  only  the  Add  radiobutton  is  activated,  a  click 
on  the  Add  button  is  just  the  same  as  adding  a  new  task  to  PANSAT’s  task  list. 

6.  The  Get  Tasklist  button  retrieves  the  current  task  list  from  PANSAT,  and  the 
Delete  Task  button  erases  the  task  currently  highlighted  in  1  from  PANSAT’s  task 
list. 

7.  The  Load. . .  button  allows  loading  PANSAT  executables  from  other  locations  than 
shown  in  the  Preferences  dialog  in  the  Task  List  Editbox  by  bringing  up  an 
appropriate  Common  Dialog  Box. 
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I. 


THE  EMBEDDING  MACRO/STATUS  DIALOG 


All  dialogs  explained  above  are  embedded  in  a 
main  dialog  template  which  extends  the  Software 
Groundstation  functionality  by  a  Macro  List  (Figure  11) 
and  a  Status  Display  (Figure  12). 

The  Macro  List  at  the  far  right  side  of  the  main 
dialog  contains  the  following  visual  controls: 


1.  Up  to  15  Macros  may  be  accessed  by  the  pushbuttons 
0  to  15.  By  clicking  these  buttons  with  the  left 
mousebutton,  the  macro  stored  in  this  place  may  be 
executed.  Macro  language  allows  recursive  execution 
of  macros  (Macro  A  invokes  Macro  B,  and  Macro  B 
invokes  Macro  A, ...).  By  clicking  one  of  these  buttons 
with  the  right  mousebutton,  the  Macro  dialog  appears 
(to  be  determined).  From  within  this  dialog,  the  user 
may  load  a  new  macro,  and  give  it  a  name  other  than 
just  a  number,  which  then  will  be  displayed  instead  of 
the  number  as  shown  in  Figure  11.  If  not  every  macro 
button  is  occupied,  the  macro  list  is  limited  to  the 
current  amount  of  macros. 


Figure  11:  The  Macro  List 


2.  The  . . .  button  switches  to  the  following  selection  of  15  macros  from  the  macro  list, 
or,  if  the  end  of  the  list  is  reached,  to  the  first  15  macros.  The  macro  list  can  be  much 
longer  than  just  15  macros.  This  button  allows  for  switching  in  portions  of  15  macros. 


The  Status  Display  on  the  bottom  of  the  main  dialog  contains  the  following  items: 


1.  The  Send  and  Receive  color  frame.  When  sending  (that  is,  transmitting  data 
through  the  serial  port),  the  dark  red  color  turns  to  bright  red.  When  receiving 
(obtaining  data  from  the  serial  port),  the  dark  blue  color  turns  to  bright  blue. 


Figure  12:  The  Status  Display 


PCL 

User 

MCtf 

•••  i 

23 


2.  The  System  Time  &  Date  Editfield  reflects  the  current  Software  Groundstation 
internal  time  and  date. 

3.  This  short  period  timer  can  be  started  by  pressing  start  or  halted  by  pressing 
Pause.  When  pressing  Start  while  pausing,  the  timer  is  reset  to  00:00:00.  Pressing 
Pause  when  pausing  resumes  the  timer.  This  timer  may  become  particularly 
important  in  order  to  achieve  a  time  perception  of  how  long  PANSAT  will  be  above 
the  earth  horizon.  It  could  be  started  when  first  establishing  contact  with  the  satellite 
and  thus  measure  the  communication  period. 

4.  The  Log  Combobox  reflects  all  actions  done  with  the  Software  groundstation.  It 
contains  Event  Zog-like  entries  which  then  are  stored  under  a  usemame-specific 
filename  according  to  the  login  (refer  to  Figure  14)  in  the  directory  referenced  to  by 
the  User  Log  Editlist  entry  of  the  Preferences  dialog  (Figure  13).  Three 
Pushbuttons  determine  what  type  of  user  action  is  shown  in  the  Log  Combobox:  PCL 
means  that  only  PCL  commands  are  shown  in  the  Log;  mcl  means,  all  commands 
(including  PCL  commands  and  the  Software  Groundstation  commands  as  used  for 
the  Script  language)  are  shown  in  the  Log.  User  then  advises  the  Log  only  to  reflect 
all  Script  language  commands  without  the  PCL  commands. 


J.  THE  LOGIN  AND  PREFERENCES  DIALOG 


Preferences 


Directoiy  SetUngs- 
Scripts: 
Macros: 
Telemetiy  Datk 
User  Log: 
Tasklist 
IN  Data: 
OUT  Data: 


Cancel 


-  m  I 


j  D:\Ground\Scnpt 
I  D:\Ground\Macro 
D:\Ground\Telmetry 
D:\Ground\Userlog 
D:\Ground\Tosk 
I  D:\Ground\IN 
|D;\Ground\OUT 


Figure  13:  The  Preferences  Dialog 


The  Preferences  dialog  as 
shown  in  Figure  13  reflects  the  contents 
of  the  OJD.INI  file.  Every  time  it  is 
invoked  by  the  appropriate  menu  item, 
the  GND .  INI  file  is  read.  When  clicking 
OK,  the  current  contents  of  the  dialog  is 
saved  to  GND. INI.  Cancel  abandons 
eventual  changes. 

The  Editfields  of  this  dialog 
determine  the  storage  directory  for 
various  grormdstation  settings.  Refer  to 
the  description  of  the  appropriate  dialog 
above  for  further  details. 
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The  Login  dialog  as  shown  in  Figure 
14  must  be  invoked  before  any 
communication  with  PANS  AT  may  be 
established.  Both  a  user  login  and  a  password 
must  be  provided.  An  internal  user  list  then 
recognizes  the  user  status.  The  groundstation 
application  divides  into  four  of  them: 

System  Administrator  (all  functionality, 
including  password  setting  for  other  users),  Super  User  (all  PANSAT-related 
functionality).  Intermediate  User  (all  PANSAT-related  functionality,  except  Low-Level 
and  Memory  dialog  features),  and  Normal  User  (only  Mail  dialog  features). 


If  PAN  SAT  Groundstation  User  Login  | 

Re^e  enter  your  login  and  password 

Login: 

|jbartschat 

Password: 

1 

Ok  1 

Cancel 

Figure  14:  The  Login  Dialog 
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IV.  DEVELOPMENT  PREPARATION  MANUAL 


This  preparation  manual  is  intended  for  use  by  a  developer  who  wants  to  continue 
developing  either  the  groundstation  software  or  create  an  application  using  a  similar 
environment.  It  consists  of  three  sections.  The  first  section  describes  the  necessary  steps 
of  installing  and  configuring  the  various  software  tools  related  to  the  development  of  the 
PANSAT  Software  Groimdstation.  The  second  section  contains  a  brief  explanation  of 
basic  programming  knowledge  necesssary  to  understand  not  only  how  the  groimdstation 
software  is  structured,  but  also  how  the  Windows  operating  system  related  applications 
are  implemented  in  general.  The  third  section  finally  puts  the  first  two  together  and 
explains  briefly,  how  the  various  software  tools  may  assist  you  in  developing  an  arbitrary 
application  taking  the  groundstation  software  as  an  example. 

The  following  will  be  very  useful  for  programmers  who  want  to  develop  their 
own  applications  in  a  similar  environment  to  the  one  used  for  the  PANSAT  Software 
Groundstation,  which  could  be  considered  as  a  typical  Windows  application.  It  assumes 
you  are  already  familiar  with  at  least  the  “Groundstation  Requirements”  chapter. 

A.  INSTALLATIONS  AND  CONFIGURATIONS 

This  section  describes  the  necessary  steps  of  installing  and  configuring  the  various 
software  tools  related  to  the  development  of  the  PANSAT  Software  Groimdstation. 

1.  Basic  Installations 

After  successfully  installing  Windows  NT  3.5  and  MSVC  2.0,  WinWidgets  (WW) 
and  Resource  Workshop  (RW)  were  installed.  Following  the  automated  installation,  these 
tools  could  still  not  interact.  The  following  steps  describe  how  to  access  RW  from  within 
MSVC,  and  how  to  tell  MSVC,  RW  and  the  current  application  to  work  properly  with 
WW. 
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2.  Connecting  the  Compiler  to  the  Resource  Workshop 


Start  MSVC.  Under  the  Tools  menu  item,  choose  Customize...  and  the 
tabbed  dialog  Tools.  Enter  the  path  to  the  Resource  Workshop  as  you  installed  it  on  the 
harddisk  under  the  Command  entry,  or  browse  for  Resource .  exe.  Enter  Workshop  or 
another  more  convenient  name  under  the  Menu  Text  entry.  Under  Argtiments,  enter 
$RC  and  every  time  you  start  RW,  the  current  *.RC  file  containing  resoiuce  information 
from  your  application  will  be  passed  to  RW  and  automatically  displayed  by  it.  Under 
Initial  Directory,  enter  $ProjDir  and  RW  knows  that  the  current  resource  file 
could  be  foimd  in  the  project  directory  created  by  MSVC.  For  a  more  detailed  description 
of  all  possible  features,  press  the  Help  button. 

Now  affirm  all  your  actions  and  leave  the  Tools  dialog.  The  Tools  menu  bar 
should  now  contain  the  new  entry  Workshop  (or  any  other  text  you  wrote  into  the  Menu 
Text  section  of  the  Tools  dialog). 

3.  Connecting  the  Compiler  and  the  Application  to 
Win  Widgets 

Once  you  have  created  an  application  skeleton  with  MSVC,  you  are  ready  to 
connect  MSVC  and  this  application  to  WinWidgets.  If  you  do  not  know  how  to  create  an 
application  skeleton,  refer  to  “Programming  with  the  Microsoft  Visual  C-H-  Compiler”. 

If  you  plan  to  use  WW  with  more  than  just  one  application,  it  makes  sense  to  put 
all  necessary  changes  in  a  text  file.  This  file  could  look  like  the  following: 
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C/C-H-  Preprocessor  AND  Resources: 
d:  \widgets\include,d:  \widgets\cpp\include 


Link  Input: 

d;  \widgets\lib\xtbl32 .  lib  d:  \widgets\lib\widge32  .  lib 

Initinstance 0 : 

Widgetsinit 0 ; 

XTablelnitO  ; 

# include  "mf cwidg . h " 

#include  "mfcxtbl.h" 

Load  this  file  into  a  text  editor  or  to  a  temporary  opened  new  text  window  under 
MS  VC.  The  four  paragraphs  contain  all  the  information  you  need  to  paste  into  MS  VC 
settings  and/or  your  application.  This  file  assumes  that  you  have  installed  WW  in  the 
Widgets  drawer  of  your  D :  drive.  If  not,  change  the  appropriate  lines  in  the  above  text. 

Invoke  MSVC  and  the  Project/Settings. .  .  dialog.  Choose  the  C/C++  tab 
and  from  the  appearing  Category  drop  list,  choose  Preprocessor.  Copy  the  line 
following  “C/C++  Preprocessor  AND  Resources:”  into  the  clipboard  and  paste  it  into  the 
Additional  Include  Directories  edit  box.  Now  choose  the  Resources  tab  in 
the  settings  dialog  and  paste  the  same  string  into  the  Additional  Include 
Directories  edit  box  of  this  tab  also. 

Now  choose  the  Link  tab  and  from  the  appearing  Category  drop  list,  choose 
Input.  Copy  the  line  following  “Link  Input:”  into  the  Object/Library  Modules  edit 
box. 

Open  the  application  file  of  your  previously  created  project.  If  you  named  your 
project  XYZ,  then  the  application  file  of  your  project  is  named  XYZ .  cpp  and  could  be 
found  in  the  drawer  XYZ  (imless  you  specified  otherwise;  this  is  the  default  setting).  In 
XYZ .  cpp,  you  find  a  method  called  Initinstance.  Copy  the  lines  following 
“InitlnstanceQ:”  at  the  beginning  of  the  Initinstance  method. 

Open  the  corresponding  include-file,  that  is,  the  include  file  named  XYZ.h.  It 
contains  application-wide  declarations  and  definitions  and  is  included  in  every  *.cpp  file 
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of  yoiar  project.  Copy  the  lines  following  “App.h:”  (this  is  meant  to  refer  to  XYZ.h,  in 
this  example)  at  the  beginnig  of  XYZ.h.  If  you  use  precompiled  headers^ ,  you  can  copy 
these  lines  into  your  stdafx.h  file  also  (automatically  created  by  the  compiler). 

4.  Connecting  the  Resource  Workshop  to  WinWidgets 

Invoke  Resource  Workshop  by  choosing  Tools /Workshop  from  within  the 
Visual  Workbench  (the  MSVC  IDE'*).  If  you  want  Resource  Workshop  to  recognize 
WinWidgets,  it  must  be  told  how  to  display  the  controls  provided  by  WinWidgets,  and 
how  to  work  with  them.  A  so-called  control  library  ships  wiith  the  WinWidgets  package. 
It  is  called  hdlg.dll  and  contains  all  visual  information  about  the  controls  in  a  dialog 
editor  readable  format.  From  within  Resource  Workshop,  choose  install  Control 
Library  from  the  Piles  menu  after  creating  a  new  dialog  with 
Resource/New/Dialog.  The  Tools  floating  dialog  should  now  be  extended  by  a 
couple  of  new  entries.  Choose  File/Add  To  Project  and  include  the  file  mfcwidg.h 
from  the  widgets /cpp/ include  directory  (your  WinWidgets  installation). 

B.  PROGRAMMING  WITH  THE  MICROSOFT  VISUAL  C++ 
COMPILER 

This  section  contains  a  brief  explanation  of  basic  programming  knowledge 
necesssary  to  understand  not  only  how  the  PANS  AT  Groundstation  Software  is 
structured,  but  also  how  Windows  operating  system  related  applications  are  implemented 
in  general.  It  assumes  you  are  familiar  with  C  and  C-H-  programming 


^  Precompiled  headers  contain  parts  of  your  application  which  are  seldomly  changed,  but  contain 
frequently  used  definitions.  When  building  your  application,  these  precompiled  headers  are  included 
without  recompiling,  thus  speeding  up  the  edit-debug  tura-aroxmd  process.  Use  project  settings  to  use  this 
feature. 

*  IDE:  Integrated  Development  Environment 
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This  description  refers  to  the  Microsoft  Visual  C-H-  Compiler  version  2.0  for  use 
under  Windows  NT.  It  is  still  valuable  for  use  with  the  previous  compiler  versions  which 
run  imder  Windows  3.x;  however,  a  few  adjustments  according  to  menu  or  dialog 
references  should  be  made  in  this  case. 

1.  General 

Programming  with  MS  VC  most  likely  means  programming  using  Windows- 
specific  environment  (in  case  of  MSVC  version  2.0  or  more,  it  means  programming  using 
Windows  NT).  As  Windows  NT  is  a  graphical  oriented  operating  system,  the  whole 
application  development  procedure  falls  into  two  parts:  first,  the  definition  of  the  GUI 
and  second,  the  actual  programming  of  the  controls  offered  by  the  GUI. 

The  first  part  (definition  of  the  GUI)  means  painting  and  designing  the  outward 
appearance  of  your  application  with  a  tool  called  a  dialog  editor.  MSVC  has  a  built-in 
dialog  editor  named  AppStudio,  and  there  are  several  other  dialog  editors  on  the  market, 
such  as  Borland’s  Resource  Workshop  which  we  are  using  to  design  applications.  Their 
input  and  output  are  text  files  containing  descriptions  of  the  controls,  menu  bars  and 
dialogs  you  chose  to  design.  These  text  files  are  compiled  by  MSVC  (or  rather  any 
Windows  based  development  system)  and  added  to  the  compiled  C/C-H-  files  of  your 
application. 

This  leads  to  the  second  part  (programming  of  the  controls  offered  by  the  GUI)  of 
the  application  development.  The  GUI  itself  is  performs  no  useful  action;  it  does  not 
contain  any  intelligent  user  interaction  code.  This  interaction  code  is  what  you  have  to 
write  in  order  to  get  your  application  working.  The  GUI  is  just  the  outward  appearance; 
the  data  structures  and  meanings  of  mouse  clicks,  menu  choices  and  so  on  is  up  to  the 
application’s  developer.  This  is  exactly  what  you  do  when  writing  C-H-  code  for  an 
application.  You  build  data  structures  to  store  internal  data  just  the  way  you  would  in  a 
non-Windows-based  program.  You  refer  to  GUI  parts  (controls,  menus,  accelerators. 
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dialogs,...)  via  #def ine’d  integer  values^ .  Windows  itself  offers  many  functions  to 
choose,  change,  and  draw  GUI  parts.  You  use  these  functions  (or  the  corresponding  MFC 
function,  see  below)  with  the  defined  integer  values  as  parameters  to  address  the  control 
you  want. 

2.  Microsoft  Foundation  Classes  (MFC) 

The  Microsoft  Foundation  Classes  is  a  class  library  that  encapsulates  Windows 
functions  in  special  classes.  Programming  with  MS  VC  primarily  means  programming 
with  MFC.  This  is  just  a  thin  layer  above  Windows,  but  it  simplifies  and  and  structures 
the  application  development.  Almost  every  function  (or,  spoken  in  C++,  method)  used  in 
the  groundstation  is  a  MFC  function.  If  you  know  how  to  program  MFC,  you  know  how 
to  program  Windows  -  and  even  a  little  bit  more. 

Windows  (NT)  is  a  message-based  operating  system.  That  means,  program  code 
is  not  executed  from  beginning  to  ending;  instead,  the  methods  the  application  contains 
are  invoked  because  Windows  invoked  them,  by  sending  messages  to  your  application. 
And  Windows  sends  messages  because  the  user  sitting  in  front  of  the  computer  clicks  or 
writes  something  within  the  application.  From  the  programmer’s  view,  most  of  this 
message  passing  is  hidden;  fortunately,  because  even  without  worrying  about  message 
passing,  Windows  programming  is  difficult.  This  message  passing  is  hidden  in  MFC  (but 
conducted  by  Windows,  as  MFC  is  only  a  layer  above  Windows  for  programmer’s 
convenience),  and  to  make  use  of  it,  MS  VC  is  provided  with  a  tool  called  ClassWizard 
(see  “Using  ClassWizard  to  Change  Your  Application”  for  details). 
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Found  in  the  Resource .  h  file  of  an  application. 
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3.  The  Document-Frame- View  Architecture 


If  you  already  have  done  serious  programming,  you  might  have  encountered  a 
problem  not  easy  to  deal  with:  your  application  grew  too  large  to  maintain  a  proper 
overview.  And  if  you  continue  to  increase  the  code,  you  start  spending  more  and  more 
time  just  looking  for  previously  programmed  code  in  order  to  find  out  about  the  correct 
software  interface  definitions  you  invented. 

As  Windows-based  applications  grow  large  quickly,  MFC  offers  a  built-in  order 
scheme  in  shape  of  the  so-called  document-frame-view  architecture  (sometimes  referred 
to  as  document-view-  or  doc-view-architecture).  The  three  parts  represent  three  different 
sections  of  your  own  application  as  far  as  the  programming  contents  is  concerned.  By 
creating  an  application  skeleton  with  AppWizard,  this  threefold  architecture  is 
implemented  automatically.  MFC  uses  special  classes  to  represent  each  part  of  this 
architecture.  You  REALLY  should  make  use  of  it. 

A  document  contains  all  the  data  structures,  calculation  methods  and  other 
internal  processing  routines  representing  the  core  of  your  application.  It  does  not  know 
anything  about  user  interaction  or  GUI  programming.  It  is  what  your  program  is  all 
about;  the  document  represents  just  pure  functionality.  It  is  normally  derived  from  the 
MFC  class  CDoc\]iaent. 

A  frame  is  all  visible  controls,  like  scrollbars,  buttons,  edit  boxes,  checkboxes, 
listboxes  and  comboboxes,  all  menu  bars  and  dialogs  and  their  controls.  In  short:  it  is  all 
you  can  click  on  and  expect  some  kind  of  action  fi-om.  As  its  name  implies,  it  is  a  frame 
for  the  application,  its  outward  appearance.  It  is  normally  derived  fi-om  the  MFC  class 
CFrameWnd. 

A  view  is  the  so-called  client  area  of  a  fi-ame.  This  is  the  blank  middle  part  of  a 
frame  in  which  you  can  make  your  application  paint,  draw  or  write  what  you  want  it  to.  It 
works  as  the  visual  interface  between  the  document  and  the  user;  thus  it  normally 
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displays  data  stored  and/or  calculated  in  the  document  to  the  user.  It  is  normally  derived 
from  the  MFC  class  CView. 

Depending  on  several  settings  and  your  own  intentions,  the  main  document,  frame 
and  view  classes  may  be  derived  from  other  base  classes  of  MFC.  These  details  are  not 
within  the  scope  of  this  thesis. 

It  is  the  programmer’s  responsibility  to  program  the  doc- view  architecture  in  the 
above  specified  way.  Once  you  have  performed  a  little  programming,  you  should  develop 
a  better  feeling  for  how  and  when  to  put  your  methods  in  one  of  the  above  parts.  MFC 
just  provides  you  with  a  framework;  you  fill  it  out  by  yourself  All  of  the  above 
mentioned  classes  can  access  the  two  others  in  a  limited  way,  so  be  careful  where  you  put 
your  methods  and  whether  they  have  to  use  features  only  supported  by  another  class. 

As  mentioned  above,  the  view  displays  document  data.  Thus,  it  has  a 
GetDocxjment  method  to  obtain  a  pointer  to  the  document  attached  to  that  view,  so  the 
view  can  access  all  public  data  of  the  document  via  this  pointer.  On  the  other  side,  the 
document  has  an  UpdateAllViews  method  which  invokes  a  special  method  inside 
every  view  attached  to  this  document.  This  method  should  be  called  when  the  document 
is  ready  with  a  lengthy  calculation.  Upon  receipt  of  this  UpdateAllViews  message,  the 
view  can  update  its  display  using  the  data  the  document  just  finished  calculating.  You, 
the  programmer  call  UpdateAllViews  from  within  your  calculation  routine  inside  your 
document  class,  because  you  know  best  when  the  data  is  ready  to  be  displayed.  The 
special  method  based  in  the  view  class  and  invoked  by  UpdateAllViews  is  named 
OnUpdate.  Knowing  this,  you  just  override  OnUpdate  in  your  view  class  and  write  a 
couple  of  lines  of  code  into  this  method  to  take  care  of  displaying  the  calculated  datg. 
This  description  is  only  intended  to  be  a  short  overview  of  what  a  message  based 
operating  system  is  capable  of  and  how  clean  it  could  be  programmed,  if  you  use  its 
capabilities  correctly. 
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4.  Project  Files 


A  C-H-  project  (sometimes  referred  to  as  an  “application”  or  “program”)  contains 
multiple  source  files  bound  together.  This  project  can  be  changed  at  any  time  during  the 
development  process.  You  normally  create  an  application  with  AppWizard,  because  this 
is  the  most  convenient  way  and  you  do  not  have  to  worry  about  the  application 
framework. 

By  default,  every  base  class  (such  as  the  document,  frame  and  view  class)  has  its 
own  include  (*.h)  and  implementation  (*.cpp)  files.  For  example,  the  groundstation 
project  name  is  “gnd”.  You  will  find  the  docrmient  class  definitions  in  gnddoc.h,  and 
the  document  class  implementation  in  gnddoc.cpp.  Same  with  the  view:  gndview.h 
and  gndview.cpp.  The  (one  and  only)  frame  resides  by  default  in  mainfrm.h  and 
mainf  rm .  cpp.  In  addition,  a  fourth  pair  of  files  is  generated:  the  application  file  in 
which  the  document,  frame  and  view  are  linked  together  in  a  so-called  document 
template:  gnd .  h  and  gnd .  cpp. 

So  far,  only  the  code  part  of  the  application  is  concerned.  What  about  the  visual 
part,  all  the  controls,  dialogs  etc.?  By  default,  a  file  named  gnd.rc  is  generated.  It 
contains  all  information  about  controls  and  dialogs,  where  they  are  placed  and  their 
properties.  This  file  must  conveniently  be  edited  in  a  visual  manner  (although  it  is  a  text 
file)  with  a  dialog  editor,  in  our  case  Resource  Workshop.  In  addition,  a  separate  file 
named  Resource. h  contains  all  the  fdefine’s  for  all  resources^,  that  is,  their  integer 
Ids. 


*  Resources  are  controls  and  dialogs.  Controls  are  scrollbars,  buttons,  checkboxes,  radiobuttons, 
listboxes,  comboboxes  and  other  custom  controls,  such  as  grids,  spin  controls,  and  so  on.  Dialogs  can 
contain  controls,  and  they  can  be  ordered  in  so-called  tabbed  dialogs  (used  by  the  groundstation). 


34 


C.  TOOL’S  REFERENCE 


This  reference  describes  the  main  tools  a  software  developer  will  be  working  with 
using  MS  VC.  Their  use  makes  programming  more  convenient;  thus  allowing  the 
developer  more  time  to  concentrate  on  the  actual  application  details  instead  of  the 
framework’s.  Parts  of  this  array  of  convenient  tools  are  the  MSVC  AppWizard  and 
ClassWizard  as  well  as  the  add-on  Borland  Resource  Workshop.  Finally,  the  MSVC 
Online  Help  as  a  necessary  source  of  all  types  of  development-related  information,  is 
most  valuable. 


1.  Using  AppWizard  to  Create  an  Application  Skeleton 

Windows  based  MFC  applications  require  a  huge  framework  overhead  before 
doing  anything  useful.  To  prevent  the  programmer  from  re-inventing  the  wheel  for  each 
application,  MSVC  is  provided  with  AppWizard  (invoked  by  File/New/Project).  It  is 
used  only  once  during  the  development:  at  the  very  beginning.  AppWizard  lets  you  define 
the  desired  features  of  your  application  by  clicking  in  its  dialogs.  Refer  to  the  Installation 
Manual  or  Online  Help  for  details.  Most  of  the  choices  are  self-explanatory.  However, 
there  are  several  things  you  must  be  familiar  with  before  you  start  AppWizard  and 
program.  You  can  easily  try  and  see  what  the  output  files  look  like  by  invoking 
AppWizard  and  choose  arbitrary  settings.  It  takes  just  a  couple  of  seconds  to  create  an 
application  skeleton,  and  everything  is  put  into  a  separate  subdirectory,  so  you  can  easily 
delete  the  entire  project  with  the  Windows  File  Manager. 

Single  Document  Interface  (SDI)  means  that  there  is  only  one  document  class  and 
normally  only  one  view  attached  to  that  document  in  your  application.  Multiple 
Document  Interface  (MDI)  creates  an  extendable  document  template,  thus  more  than  one 
document  class  can  be  used,  and  usually  more  than  one  view  can  be  created,  too.  With 
groundstation,  the  SDI  concept  was  used. 
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You  can  also  choose  OLE’  capabilities  as  well  as  database  support  via  ODBC* 
compatibility.  These  are  advanced  topics  you  should  not  use  unless  you  fully  understand 
what  they  support. 

2.  Using  ClassWizard  to  Change  Your  Application 

Class  Wizard  can  be  used  to  maintain  and  change  classes,  use  the  message  map 
system  to  link  visual  controls  to  program  code  or  change  class  member  variables.  It  can 
also  be  used  for  OLE  related  maintenance,  which  is  not  described  here.  The  most 
essential  and  often  used  task  with  ClassWizard  is  its  message  map  maintenance 
capability.  To  understand  a  little  bit  better  how  ClassWizard  works,  you  must  first  learn 
how  to  implement  the  message  map  system  without  use  of  ClassWizard. 

As  mentioned  above  Windows  (NT)  is  a  message  based  operating  system.  Thus, 
every  application  programmed  for  use  with  Windows  and  taking  advantage  of  its 
graphical  capabilites,  must  be  able  to  do  message  passing  from  and  to  Windows.  In  MFC, 
this  goal  is  achieved  by  the  concept  of  message  maps  and  window  functions. 

A  message  map  is  a  set  of  commands  which  tell  Windows 

•  which  type  of  message  Windows  should  catch, 

•  to  which  visual  control  the  message  should  be  attached  to, 

•  which  window  function  should  be  executed  upon  receipt  of  this  message. 

^  OLE:  Object  Linking  and  Embedding.  This  technique  allows  users  to  link  or  physically  embed 
(include)  objects  created  from  OLE  servers  into  an  OLE  client  application.  An  OLE  client  application 
serves  as  a  container  for  data  created  by  OLE  servers.  OLE  itself  is  the  standardized  interface  to  allow  OLE 
item  interchange  by  copy/paste  or  drag  and  drop. 

ODBC:  Open  Database  Connectivity.  This  standardized  interface  definition  simplifies  database 
record  interchange  between  DBMS  (Database  Management  Systems)  as  well  as  ODBC  compatible  C-h- 
applications  (for  example).  It  requires  ODBC  drivers  for  both  sides  of  the  interchange  chain,  which  are 
available  from  third  party  developers. 
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It  looks  something  like  the  following: 


BEGIN_MESSAGE_MAP  (CGndView ,  CView) 

// { {AFX_MSG_MAP (CGndView) 

0N_C0MMAND  ( ID_ACCESS _ ^LOGON ,  OnUserAccess ) 

ON_COMMAND  ( ID_ACCESS_LOGOFF ,  OnEndUserAccess ) 

ON_COMMAND ( ID_PREFERENCES ,  OnPref erences ) 

// }  }AFX_MSG_MAP 
/  /  S'tandard  prin'ting  commands 
ON_COMMAND  ( ID_FILE_PRINT ,  CView :  :  OnFilePrint) 
ON_COMMaND(ID_FILE_PRINT_PREVIEW,  View:  : OnFilePrintPreview) 
END_MESSAGE_MAP ( ) 

The  0N_C0MMAND  macro  tells  Windows  that  the  type  of  message  is  a  command 
message.  The  first  parameter  refers  to  the  visual  control  whose  activation  you  want  to 
catch.  For  example,  the  above  id_access_logon  identifier  (as  defined  in 
Resource  .h)  refers  to  a  menu  entry  in  the  main  menu  of  the  groundstation  application. 
And  every  time  the  user  activates  the  menu  entry  with  this  specific  ID,  the  method 
OnUserAccess  is  invoked.  This  special  method  is  also  called  window  function  or 
message  handler.  It  is  part  of  the  class  for  which  this  message  map  is  defined,  in  this 
case  CGndView  which  is  derived  from  the  MFC  class  CView  -  the  former  being  the  view 
class  of  the  groimdstation.  This  information  is  given  by  the  parameters  of  the 
BEGIN_MESSAGE_MAP  macro.  The  whole  message  map  as  shown  could  be  found  in  the 
implementation  file  for  the  application  view,  gndview .  cpp.  Every  class  containing  a 
DECLARE_MESSAGE_MAP{)  macro  in  its  class  declaration  (to  be  found  in  gndview. h 
for  this  example)  can  contain  a  message  map  of  the  type  shown  above. 

Besides  the  entries  into  the  message  map,  there  are  two  additional  things  to 
remember  in  order  to  make  the  message  passing  mechanism  work:  the  declaration  of  the 
window  fimction  in  the  class  declaration  file,  and  the  definition  of  the  window  function  in 
the  implementation  file. 

The  declaration  of  window  functions  could  look  like  this: 
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protected : 

//  Generated  message  map  fxinctions 
// { {AFX_MSG (CGndView) 
afx_msg  void  OnUserAccess () ; 
afx_msg  void  OnEndUserAccess () ; 
af x_msg  void  OnPreferences ( ) ; 

//} }AFX_MSG 
DECLARE_MESSAGE_MAP ( ) 

All  window  function  declarations  start  with  afx_msg.  Right  now,  this  #def ine 
resolves  to  void;  however,  future  versions  of  MFC  may  redefine  its  meaning.  No  window 
function  does  return  a  value,  and  only  some  take  parameters.  This  excerpt  is  located  in 
gndview .  h  in  the  CGndView  class  declaration. 

The  definition  of  the  window  function  looks  somewhat  like  this: 


void  CGndView: : OnUserAccess 0 
{ 

//  Put  your  code  handling  the  activation  of  the  Access /User 
//  menu  item  from  the  groundstation  main  menu  here 

} 

Conclusion:  add  a  control  item  handler  to  your  application  by 

•  adding  an  appropriate  entry  into  the  message  map  of  the  appropriate  class, 

•  add  a  window  function  declaration  to  the  class  declaration, 

•  write  the  window  function  into  the  implementation  file  of  the  appropriate  class. 


In  most  cases,  you  do  not  have  to  remember  those  steps  nor  the  changes  you  have 
to  make  to  the  *.h/*.cpp  pair  of  files  of  the  appropriate  class.  Instead,  you  use 
ClassWizard  (Project/ClassWizard  and  the  Message  Maps  tab  from  within  the 
Visual  Workbench).  You  see  all  classes  recognized  by  ClassWizard  available  in  the 
Class  name  combobox.  Choose  the  appropriate  class;  if  you  do  not  know  what  the 
appropriate  class  would  be,  review  “The  Document-Frame-View  Architecture”  discussed 
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above,  or  refer  to  appropriate  help  files  within  the  MSVC  Online  Help.  Then  choose  the 
ID  of  the  visual  control  you  want  to  create  a  window  function  for  from  the  Object  IDs 
listbox,  and  the  message  type  in  the  Messages  listbox.  Normally  you  only  have  the 
choice  between  command  and  UPDATE_UI,  and  most  of  the  time  COMMAND  is  chosen. 
You  specify  the  name  of  the  window  function  and  click  Add  Function;  and  all  of  the 
above  changes  are  made  automatically. 

However,  sometimes  ClassWizard  does  not  recognize  all  classes.  Either  rebuild 
your  ClassWizard  database  by  deleting  the  *.clw  file  (i.e.,  gnd.clw)  first,  then  invoke 
ClassWizard  and  follow  the  instructions,  or  implement  the  necessary  lines  of  code 
yourself. 


3.  Using  the  Resource  Workshop  Dialog  Editor 

Borland’s  Resource  Workshop  (RW)  is  an  advanced  dialog  editor^  for  Windows 
or  Windows  NT  and  is  intended  to  be  used  with  any  software  development  application 
which  understands  and  implements  the  commands  defined  for  Resources  (extension  *.rc). 
An  *.rc  file  (resource  file)  is  a  text  file  that  can  be  edited  with  any  text  editor;  any 
changes,  which  are  in  compliance  with  the  Resource  Language,  made  to  this  kind  of  file 
thus  will  be  recognized  correctly  the  next  time  RW  processes  it.  However,  this  is  not  the 
recommended  way  to  change  your  resource  file.  RW  allows  changing  these  files  in  a 
graphical  manner.  If  you  want  to  learn  about  editing  a  resource  file,  read  the  instructions 
in  the  help  files  provided  with  RW.  Nonetheless,  a  short  list  of  information  is  provided 
which  you  should  be  aware  of  before  you  actually  should  use  RW,  and  for 
troubleshooting  using  RW  in  connection  with  AppStudio. 


’  Dialog  Editor:  every  software  tool  which  is  able  to  edit  a  resource  file  in  a  visual  manner.  This 
includes  not  only  dialogs,  as  the  name  might  suggest,  but  every  kind  of  resource  type  and  visual  control. 
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The  normal  working  procedure  of  a  dialog  editor  is  a  useful  thing  to  know, 
because  in  case  of  errors  you  will  be  able  to  tell  more  quickly  where  this  error  might  have 
occurred.  This  description  is  not  limited  to  RW;  other  dialog  editors  work  similarly. 

When  starting  up  RW,  either  the  corresponding  resource  file  is  loaded 
automatically  (from  within  the  Visual  Workbench,  if  you  have  defined  the  appropriate 
parameters),  or  you  have  to  open  or  create  a  new  one  (when  using  RW  as  a  stand-alone 
dialog  editor).  But  first,  what  is  a  resource?  Every  kind  of  data  which  normally  refers  to 
the  outward  appearance  of  an  application  is  stored  as  a  resource.  It  can  be  edited  and 
compiled  separately  from  the  application  code,  and  it  can  be  loaded  to  or  discarded  from 
memory  at  any  time  the  user  invokes  certain  resource-based  visual  controls  or  the 
operating  system  needs  memory.  When  working  with  large  applications  on  a  small 
computer  system,  you  might  have  encountered  a  delay  and  harddisk  access  when  you 
clicked  on  a  menu  or  invoked  a  dialog.  In  this  case,  the  operating  system  discarded 
former  instances  of  these  resource  types  from  memory  and  had  to  load  them  again  at  the 
time  you  needed  them. 

You  are  able  to  create  and  edit  all  kinds  of  resource  types,  such  as  dialogs, 
accelerators  (key-invoked  commands),  menus,  bitmaps,  cursors,  fonts,  icons,  stringtables 
(lists  of  strings  you  wish  to  put  in  resources)  and  a  couple  of  others  not  commonly  used. 
Dialogs  are  the  most  complex  of  these  resource  types  because  they  can  be  related  to  all  of 
the  above  types  ^  the  visual  controls.  Visual  controls  in  general  are  all  kinds  of  visual 
gadgets  you  expect  a  reaction  from  when  clicking  them  with  the  mouse  pointer.  Thus, 
visual  controls  are  pushbuttons,  checkboxes,  radiobuttons  and  a  couple  more  button 
derivatives,  listboxes,  comboboxes  (drop-down  listboxes),  statics  (statically  displayed 
text),  editfields  (editable  text)  and,  in  case  of  the  WW-package,  many  more  sophisticated 
visual  controls,  such  as  grid  controls,  spin  controls,  tab  controls,  toolbars  and 
spreadsheet  controls.  To  learn  more  about  those  visual  controls,  refer  to  the  WW  help 
files  and  [Ref  1]. 
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As  every  resource  type  and  visual  control  can  be  customized  (which  will  be  done 
in  most  of  the  cases),  the  programmer  has  to  define  their  properties.  This  is  done  inside 
RW  by  just  double-clicking  the  desired  resource  and  define  or  alter  the  parameters 
presented  in  the  upcoming  properties  dialog  box.  In  case  of  the  WW  button,  for  example, 
the  programmer  first  has  to  decide  whether  to  use  a  pushbutton,  a  checkbox  or 
radiobutton  (which  are  buttons  the  way  WW  understands  it),  a  tristate  or  grouped  button 
(two  or  more  buttons  linked  together,  of  which  only  one  can  be  pressed  down).  Then  he 
can  go  on  defining  the  appropriate  text,  icon,  flags  and  other  parameters  needed  to  display 
the  visual  control  correctly. 

Every  visual  control  has  its  own  properties.  Refer  to  the  appropriate  help  files  and 
reference  manuals  for  further  information,  or  just  use  a  trial-and-error  strategy  as  most  of 
the  property  definitions  (flags,  positions,  entries,  height,  width,  sub-controls,...)  are  self 
explanatory. 

Most  dialog  editors  (and  RW  is  not  an  exception)  use  two  files  to  store  their 
information.  First,  in  an  *.rc  resource  file  the  location  and  properties  of  resource  types 
and  visual  controls  is  encoded  in  Resource  Language.  Second,  a  *.h  resource  header  file 
(in  case  of  MSVC,  resource. h)  contains  all  necessary  #define’s  which  serve  as  an 
interface  between  the  resource  file  data  (from  the  *.rc  file)  and  the  code  added  by  the 
programmer  to  access  this  data  fi-om  within  the  C++  code  (from  within  the  C++  source 
files).  The  programmer  defines  control  names  for  every  visual  control  he  creates  using 
RW.  By  convention,  they  are  all  uppercase,  starting  with  idc  {control  identification)  with 
underscore  keys  to  separate  the  descriptive  parts.  These  definitions  are  converted  to 
#de£ine’s  in  resource. h  as  integer  values.  The  programmer  refers  to  a  visual 
command  inside  his  C++  source  by  using  the  control  name  defined  in  RW,  and  the 
compiler  resolves  to  the  appropriate  integer  value  because  of  the  entries  in  resource  .h. 

Conclusion:  What  you  basically  do  with  a  dialog  editor  is 
•  load  or  create  a  resource  file. 
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•  choose  the  desired  resource  type  and  define  its  properties,  and,  in  case  of  a  dialog, 

•  place  visual  controls  wherever  you  want  them  to  appear,  defining  their  properties 
and  often  customizing  their  width  and  height  as  well  as  the  alignment  to  other  visual 
controls,  and  finally 

•  saving  the  edited  resources  to  your  resource  file. 

All  steps  following  this  process  (compiling  the  resource  file,  including  it  into  your 
application)  are  done  automatically  by  the  MSVC  compiler  and  linker  and  thus  are 
independent  from  RW.  The  “only”  remaining  is  actually  programming  the  RW-defmed 
resources.  What  you  created  with  RW  is  just  the  outward  appearance  of  your  application, 
but  no  functionality  except  the  default  visual  control  behaviour'®  is  implemented.  The 
programmer  himself  has  to  take  care  of  how  every  visual  control  behaves  and  what 
reaction  it  produces.  He  can  rely  on  the  classes  provided  with  MSVC  and  WW  in  order  to 
access,  control  and  alter  every  visual  control.  This  makes  clear  that  the  actual 
programming  has  to  be  done  after  the  resources  have  been  designed  with  a  dialog  editor. 

RW  normally  ships  with  the  Borland  C++  Compiler,  but  can  also  be  used  as  a 
stand-alone  application.  This  makes  it  valuable  for  use  with  MSVC,  the  biggest 
competitor  for  Borland’s  C++  compiler  on  the  market  right  now.  The  current  RW  version 
4.5  allows  basically  all  operations  which  would  be  possible  to  perform  with  the  MSVC 
built-in  AppStudio.  However,  in  contrary  to  AppStudio  the  RW  Dialog  Editor  allows 
installation  of  additional  control  libraries,  which  is  a  necessary  feature  to  use  the 


Default  visual  control  behaviour;  every  action  done  automatically  with  a  visual  control  by  the 
framework.  Examples;  clicking  on  a  checkbox  or  radiobutton  alters  the  state  and  visual  appearance  from 
“not  crossed”  to  “crossed”  (“not  bulleted”  to  “bulleted”  in  case  of  a  radiobutton)  or  the  other  way  aroimd, 
respectively.  Using  a  combobox,  the  framework  takes  care  of  highlighting  clicked  entries,  dropping  down 
and  displaying  entries  as  well  as  scrolling  them  with  an  associated  scrollbar;  the  programmer  has  to  provide 
the  text  of  the  entries. 
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WinWidgets  Custom  Control  package.  This  is  a  big  advantage  of  RW  and  the  reason  RW 
was  chosen  instead  of  AppStudio. 

But  there  are  also  several  disadvantages  using  RW  a  programmer  must  be  aware 
of,  especially  when  he  is  already  used  to  working  with  AppStudio.  As  correct  handling 
requires  only  minor  effort,  RW  is  still  the  appropriate  choice. 

RW  does  not  support  automatic  control  name  numbering  as  supported  by 
AppStudio.  Thus,  the  programmer  has  to  check  frequently  the  integer  values  as 
#define’d  in  resource. h.  You  should  not  use  integer  values  more  than  once,  because 
the  compiler  will  resolve  to  the  visual  controls  according  to  these  values.  You  might  lose 
track  of  which  value  you  already  used.  Furthermore,  you  will  have  to  use  AppStudio  as 
well  as  RW^  ^ ,  and  thus  have  to  adjust  manual  numbering  as  necessary  with  RW  to 
automatic  numbering  as  supported  by  AppStudio.  This  basically  limits  you  to  which 
integer  values  you  can  use;  refer  to  the  AppStudio  User’s  Guide  provided  with  the  MS  VC 
help  files  for  further  information,  and  check  some  resource .  h  files  as  reference. 

It  also  might  happen  that  RW  complains  about  AppStudio-processed  *.rc  resource 
files.  There  are  two  possible  reasons  for  this.  The  first  is  due  to  an  AppStudio  or  RW  bug: 
several  lines  in  the  resource  file  are  copied  twice  into  the  edited  file,  thus  making  correct 
processing  impossible.  Just  delete  those  lines  with  a  normal  text  editor;  RW  will 
complain  about  this  error  with  a  line  number  as  reference.  Second,  a  #def  ine  used  and 
sometimes  discarded  by  AppStudio  may  prevent  RW  from  correctly  processing  it.  Just 
#def  ine  it  again  in  the  resource  file,  and  RW  will  process  just  fine. 


"  This  will  happen  when  you  have  to  rebuild  the  ClassWlzard  database  (*.clw)  in  order  to  let  it 
recognize  non-MSVC  classes  (as  used  with  WW).  In  this  case,  you  will  have  to  invoke  AppStudio  prior  to 
Class  Wizard,  because  ClassWizard’s  database  relies  on  correct  resource  file  entries.  Sometimes  processing 
errors  might  occur  when  invoking  a  RW-edited  *.rc  resource  file  from  within  AppStudio.  Most  of  the  times 
this  is  because  of  some  additional  *.h  header  files  were  not  included  in  an  AppStudio-conform  way. 
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4.  Using  the  Online  Help  and  the  Contents  Browser 


As  development  platforms  such  as  MS  VC  are  very  complex  applications,  hardly 
any  programmer  can  memorize  all  classes,  their  methods,  their  parameters  and  return 
values  (there  are  a  couple  of  himdreds  of  them).  Either  a  programmer  has  kilograms  of 
books  right  beside  him  while  programming,  or  he  makes  use  of  the  built-in  online  help 
capability.  In  fact,  the  most  convenient  way  is  a  combination  of  both. 

There  are  two  kinds  of  information  you  might  want  to  obtain  while  developing  an 
application.  First,  information  about  Windows  functions,  C/C++  features  and  other  things 
already  shipped  with  the  compiler.  Use  the  Online  Help  for  that  information.  Second, 
your  self-programmed  variables,  structures,  classes  and  methods.  For  this  kind  of 
information,  use  the  Contents  Browser. 

Invoke  the  Online  Help  with  the  FI  key  while  the  cursor  is  placed  over  a  method 
or  a  defined  variable,  a  C/C++  keyword  or  any  other  code  you  expect  to  be  considered  in 
the  help  database.  However,  Visual  Workbench  will  tell  you  very  soon  whether  it 
recognizes  the  data  beneath  the  cursor  or  not.  For  example,  if  you  want  to  know  more 
about  the  class  CString  (which  could  be  completely  unknown  to  you  now,  but  which 
you  really  should  try  to  learn  more  about),  just  place  the  cursor  somewhere  in  the  word 
CString  and  press  FI.  Another  way  to  access  the  online  help  is  via  the  Help  menu.  You 
can  read  all  information  available  on  paper  for  MSVC  with  Books  Online  (if  you  have 
the  CD  version  of  MSVC  2.x).  Other  useful  information  can  be  found  in  the  various 
Hierarchy  Charts,  which  are  a  good  place  to  start  for  general  information  about  MFC  and 
its  classes.  The  online  help  will  become  a  very  helpful  tool  for  you  while  developing  your 
application. 

Naturally,  you  will  not  get  a  full  description  of  your  own  code  unless  you  Avrote  a 
couple  of  lines  about  it.  What  you  can  get  from  the  Visual  Workbench  is  the  location  of 
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the  declaration*^  and  the  definition*^  of  your  code.  Use  the  Fll  key  from  within  the 
Visual  Workbench  while  the  cursor  is  placed  over  the  code  you  want  to  obtain  the 
declaration  from,  or  Shift-Fll  for  the  definition.  Every  time  you  compile  your 
application,  a  new  browser  database  is  created  to  reflect  the  latest  changes  to  variable 
declarations  and  definitions.  You  can  switch  this  feature  on  or  off  in  you  Project  settings 
(Project/Settings .  .  . ,  tab  C/C++,  checkbox  Generate  Browser  Info). 


12  • 

Declaration:  letting  the  compiler  know  of  what  type  the  variable  is.  Does  not  use  any  memory. 
Example:  int  i;  declares  a  variable  named  i  as  of  type  int.  The  Visual  Workbench  uses  the 
expression  “Definition”  for  that  matter. 

Definition:  assigning  a  value  to  a  variable  which  previously  has  been  declared.  Uses  the 
amount  of  memory  the  variable  type  uses.  Example:  i  =  100 ;  allocates  2  bytes  (under  Windows  3.x) 
or  4  bytes  (under  Windows  NT)  of  memory  to  store  an  integer  variable  of  value  100  in  that  memory,  and 
letting  the  programmer  refer  to  it  as  i.  The  Visual  Workbench  uses  the  expression  “Reference”  for  that 
matter.  C  and  C++ allow  mixed  declarations  and  definitions:  int  i  =  100;. 


45 


V.  PROGRAMMER’S  REFERENCE 


This  reference  describes  the  programming  of  the  PANSAT  Software 
Groundstation.  It  contains  a  much  more  detailed  description  of  the  actual  procedure  to 
program  Windows  or  Windows  NT  with  C++  than  other  chapters.  Thus,  you  should 
already  be  familiar  with  all  preceeding  chapters,  programming  in  a  high-level  language, 
especially  in  C  or  C++,  and  exhibit  an  advanced  knowledge  about  graphical  oriented 
operating  systems,  commonly  used  data  structures  and  programming  techniques. 

A.  THE  GROUNDSTATION  DOCUMENT 

The  groundstation  document  is  not  only  placed  in  the  CDoctiment  derived  class 
of  the  gnd  application,  but  expands  to  some  other  structures  whose  implementation  could 
be  found  in  the  gnddoc.cpp  file  also,  as  they  logically  belong  to  the  application’s 
document.  Because  all  of  these  additional  structures  must  be  accessible  from  every  class 
of  the  application,  they  are  defined  globally  and  statically'"'  in  the  gnd.h  file  (which  is 
included  into  every  *.cpp  file  created  by  AppWizard  by  default). 

1.  Classes  and  Structures 

A  class  encapsulates  data  and  functions  (they  are  called  methods  when  they  are  a 
part  of  a  class)  in  one  structure.  This  is  a  simple,  but  very  effective  way  to  keep  data  and 
functions  accessible  only  from  where  an  access  makes  sense,  that  is,  only  within  the  class 
for  which  they  are  defined.  A  structure  in  the  original  meaning  is  just  an 
encapsulation  of  data,  that  is,  variables  and/or  substructures.  The  C++  language  expands 


Static  variables  only  use  one  memory  location,  no  matter  how  often  they  are  declared  and 
defined.  This  ensures  that  every  method  using  this  variable  uses  exactly  this  variable  and  not  a  locally 
defined  other  variable  with  the  same  name.  Static  variables  use  the  C/C-h-  static  keyword  before  their 
type  identifier:  static  int  i ;  declares  a  static  variable  named  i  of  type  integer. 
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this  meaning  allowing  C++  struct’ s  to  be  equivalent  to  a  class:  not  only  data  members, 
but  also  functions  (methods)  can  be  encapsulated  in  structures. 

The  only  difference  between  class’es  and  struct’s  is  the  default  access 
behaviour.  Certain  C++  keywords  determine  the  accessability  of  data  members  or 
methods  (furthermore  referred  to  as  “members”):  public,  protected,  and  private. 
They  determine  whether  non-class  methods  can  access  class  members,  and  how  they  are 
accessed  in  derived  classes.  Refer  to  the  online  help  for  further  information. 

The  most  important  structures  belonging  to  the  document  are  not  part  of  the 
CDocument  derived  class  CGndDoc  because  they  deserve  unique  structures.  These  are 
the  PCL  output  structures  struct  SMacro,  struct  SCmd  and  the  PCL  input  structure 
struct  SReturnCmd.  They  contain  all  necessary  members  to  cope  with  the  problem  of 
sending,  receiving,  storing  and  loading  data  from  and  to  disk,  and  from  and  to  PANSAT 
via  the  serial  interface.  Furthermore,  all  necessary  information  about  PCL  is  stored  in  the 
program  command  database  inside  the  definition  of  struct  SDocumentCmd.  Both 
the  structure  declaration  struct  SDociimentCmd  and  its  definition  (named  DocCmd) 
can  be  found  in  Gnd .  h,  like  all  the  declarations  of  the  structures  mentioned  above. 

2.  The  PCL  Output  Structures 

The  PCL  output  stractures  struct  SMacro  and  struct  SCmd  are  based  on  the 
information  given  by  the  program  command  database  stored  in  const  static 
SDocumentCmd  DocCmd  [  ] .  In  this  chapter  the  following  questions  will  be  answered: 

•  What  is  a  macro,  what  is  a  script?  What  is  a  command? 

•  What  are  the  contents  of  the  program  command  database? 

•  How  does  PCL  ouqjut  work  with  the  macro  and  command  structures? 
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a.  The  macro/command  relationship 

A  command  is  one  (1)  PCL  command'^  and  its  parameters,  if  applicable.  A 
macro  is  a  sequence  of  commands.  A  script  is  a  sequence  of  commands  including  at 
least  one  script  command^®  .  The  C-H-  structures  used  for  representing  this 
relationship  are  struct  SMacro  and  struct  SCmd: 


PCL  command:  every  command  recognized  in  the  program  command  database  which  represents 
a  command  to  PANSAT. 

Script  command:  every  command  in  the  program  command  database  which  is  not  intended  to 
be  sent  to  PANSAT,  but  controls  the  groundstation  software.  No  script  command  is  implemented  yet. 
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struct  SMacro 

{ 

public : 

SMacro  ( )  ; 

SMacro (int  nindex) ; 

SMacro  (const  char  *pName)  ; 
virtual  '^SMacro  ()  ; 
public : 

virtual  int  Load(); 
virtual  int  Save(); 
virtual  int  Overwrite (); 
virtual  int  Execute (); 
virtual  int  GetError() ; 

BOOL  IsScriptO; 
protected: 

BOOL  nMbHas Changed; 
int  nError; 
private : 

const  char  *GetFileNaine ()  ; 

BOOL  SetFileName  (const  char  *pName)  ; 
const  char  *GetMacroNaine  ()  ; 
void  SetMacroName  (const  char  *pNaiae) 
private : 

CString  FileName; 

CString  MacroName; 

CPtrArray  cmd; 

BOOL  in__bHasFileName; 

BOOL  m^blsBuiltln; 

BOOL  m_bIsScript; 
friend  class  CCHScriptsDlg; 

}; 


struct  SCmd  :  ptiblic  SMacro 

{ 

public: 

SCmdO  ; 

SCmd (int  nindex) ; 

-SCmdO  ; 
public : 

_ int  8  cmd; 

_ inti 6  wParam; 

long  IParam; 
void  *ptr ; 
pxablic : 

virtual  BOOL  Load (void  *fh) ; 
virtual  BOOL  Save (void  *fh)  ; 
virtual  BOOL  Execute (void  *fh) ; 
protected: 
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virtual  long  GeneratePassword() ; 

BOOL  Readstring (void  *fh,  long  *pLong,  int  *pnErr) ; 
BOOL  Wri testring (void  *fh,  char  *pchar,  int  *pnErr) ; 


scmd  is  derived  from  SMacro  and  thus  “knows”  about  everything  what  is 
derivably  defined  in  SMacro.  The  SCmd  structure  has  to  comply  with  several 
requirements: 

•  Store  every  possible  command  in  an  identifiable  manner, 

•  Provide  storage  capability  for  every  possible  parameter  or  combination  thereof  for 
every  possible  command, 

•  Provide  disk  I/O  fimctionality  to  save  or  load  one  (1)  command  from  or  to  disk, 

•  Feature  serial  output  for  one  (1)  command. 

These  goals  are  achieved  by  the  various  members  of  the  SCmd  structure. 
Furthermore,  it  contains  several  more  members  to  construct  a  command,  generate  a 
password  (if  applicable)  and  simplify  disk  access.  The  four  members  cmd,  wParam, 
IParam  and  ptr  serve  as  storage  for  every  possible  command  (member  cmd)  and  its 
parameters  (members  wParam,  IParam  and  ptr),  the  latter  of  which  represent  data  types 
and  structure  pointers  according  to  the  entries  in  the  program  command  database  (see 
“The  Contents  of  the  Program  Command  Database”). 

Disk  I/O  is  done  by  the  methods  Load  and  Save;  command  execution  (which  is 
very  similar  to  disk  I/O  functionality  except  that  data  is  sent  to  COMl)  is  performed  by 
Execute.  These  three  I/O  methods  require  an  already  opened  I/O  channel  whose  handle 
they  take  as  the  only  parameter  (void  *fh,  fh:  File  Handle).  This  task  is  completed  by 
the  SMacro  structure  described  below.  The  file  routines  used  here  are  part  of  Windows 
and  Windows  NT.  For  more  information  about  programming  with  these  routines,  refer  to 
“The  Implementation  of  the  Output  Structures”  discussed  later  in  this  chapter. 
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SMacro  is  the  more  general  one  of  the  output  structures.  It  takes  care  of  several 
file  and  data  channel  maintenance  tasks: 

•  Opening  and  closing  the  I/O  channels  for  disk  I/O  and/or  serial  output, 

•  Provide  storage  for  the  filename  associated  with  this  macro  and  the  macro  name  and 
means  to  change  those  names, 

•  Prevent  the  user  from  involuntarily  erasing  altered  macros, 

•  Provide  the  programmer  with  an  easy  error  handling  capability, 

•  Provide  means  to  store  a  virtually  imlimited  amount  of  commands  (each  represented 
by  a  scmd  structure). 

These  goals  once  again  are  achieved  by  the  various  members  of  SMacro.  The  two 
disk  related  methods  Load  and  Save  use  the  Windows  Common  Dialog  Box  feature  to 
present  dialog  boxes  to  open  an  I/O  channel  for  loading  or  saving  data  from  or  to  disk. 
Refer  to  [Ref.  2]  for  further  information.  The  actual  load  or  save  procedure  then  can  be 
conducted  by  invoking  the  Load  or  Save  method  of  scmd;  this  is  done  for  every 
command  that  this  macro  contains,  so  the  whole  sequence  of  commands  can  be  loaded  or 
saved.  The  SMacro-method  Execute  works  similar  to  that:  it  just  opens  the  I/O  chatmel 
to  COMl  and  leaves  the  rest  to  the  SCmd  Execute  method. 

SMacro  owns  two  data  members  in  which  the  macro  name  and  the  filename  of 
the  macro  are  stored:  CString  MacroName  and  CString  FileName.  This  class 
provides  the  programmer  with  a  dynamically  length-adapted  string  storage  as  well  as 
many  useful  methods  for  string  handling  and  conversion.  The  CString  class  as  part  of 
the  Microsoft  Foundation  Classes  (MFC)  General  Purpose  Classes  is  subject  to  a  closer 
discussion  later  in  the  text.  The  four  SMacro  members  GetFileName,  SetFileName, 
GetMacroName  and  SetMacroName  offer  easy  methods  for  the  programmer  to  retrieve 
a  string  (Get...  members)  from  the  user  and  store  it  into  the  cstring  data  members 
MacroName  and  FileName  (Set...  members). 
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The  BOOL  member  m_bHas  changed  should  always  be  set  to  TRUE  everytime  the 
macro  has  been  changed.  The  disk  I/O  methods  Load  and  Save  as  well  as  the  class 
destructor  check  for  this  boolean  variable  prior  to  erasing  operations  and  thus  prevent 
from  involuntary  data  loss.  The  programmer  is  responsible  for  setting  this  variable  to  the 
appropriate  value  every  time  edit  or  storage  actions  have  occurred. 

Many  errors  might  occur  during  I/O  actions.  Especially  the  Load,  Save  and 
Execute  methods  contain  a  multitude  of  I/O  actions;  thus,  they  contain  several  error 
checks.  The  integer  return  values  of  those  functions  refer  to  the  ErrAry  text  array 
(Gnd .  h).  They  represent  the  zero-based  index  of  the  string  entries  in  this  text  array. 

So  far,  no  members  of  SMacro  refer  to  a  PCL  or  script  command  or  their 
parameters.  This  is  done  on  purpose  because  the  SCnid  structure  already  covers  that  whole 
problem.  As  multiple  commands  can  be  part  of  a  macro,  SMacro  contains  the 
CPtrArray  cmd  member  to  provide  means  for  storage.  It  provides  a  dynamically 
growing  (or  shrinking)  array  of  pointers  to  whatever  you  want  pointers  to  (to  SCmd 
structures  in  this  case).  The  CPtrArray  class  is  part  of  the  MFC  Collection  Classes  and 
subject  to  later  discussion. 

b.  The  Contents  of  the  Program  Command  Database 

The  program  command  database  is  located  in  Gnd.h  and  consists  of  the  structure 
declaration 

struct  SDocijmentCmd 
{ 

char  ^command; 

_ ^intS  cmdID; 

int  flags ; 

int  wParam_Type ; 

int  lParaiii_Type ; 

int  return_Type; 

} ; 

and  the  structure  definition  (excerpt) 
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const  static  SDocumentCmd  DocCmd[]  = 

{ 

{  "add_coinmand"  ,  0x0 1 ,  FPCL  |  FSUPER I FPASS , 

TVOID  I  TQ_CMDPTR,  TL_UTC,  TVOID} , 

{"add_task",  0x02,  FPCL | FSUPER | FPASS , 

TQ_TASKPTR,  TVOID,  TVOID}, 

{ "boot_rom" ,  0x03 ,  FPCL | FSUPER | FPASS , 

TVOID,  TVOID,  TVOID}, 


}; 

The  six  parameters  of  this  structure  contain  all  information  necessary  for  the  I/O 
classes  to  perform  successfully.  The  char  *coinmand  member  contains  a  pointer  to  the 

plain  command  string,  the _ ^intS  cmdiD  member  (an  eight-bit  integer,  Microsoft- 

specific  data  type)  the  according  command  identification  value.  The  third  member 
int  flags  is  a  value  of  OR’able  tdefine’s  also  found  in  Gnd.h:  all  those 
commencing  with  an  F.  The  last  three  members  contain  type  information  about  the 
variable  which  is  about  to  be  stored  in  the  SCmd  members  wParam  and  IParam  as  well  as 
the  SReturnCmd  member  ptr.  The  appropriate  #def  ine’s  all  start  with  T  indicating  a 
type  identifier.  Refer  to  the  comments  added  to  the  source  text  in  Gnd.h  for  further 
information. 


c.  The  Implementation  of  the  Output  Structures 

The  most  important  thing  about  the  output  structures  SCmd  and  SMacro  are  the 
I/O  function  calls.  The  structure  implementation  resides  in  the  GndDoc .  cpp  source  file. 
You  can  find  out  more  about  the  used  methods  in  [Ref  3]  and  [Ref  4].  However,  first 
you  want  to  learn  more  about  CreateFile,  ReadFile  and  WriteFile  first. 

At  first  glance,  the  SCmd  member  functions  Load,  Save  and  Execute  look 
identical.  However,  there  are  a  few  differences.  The  disk  I/O  methods  do  not  have  to  save 
or  load  passwords  because  they  are  only  needed  when  uplinking  commands  to  PANSAT. 
Therefore,  only  the  Execute  method  uses  password  generation  via  a 
GeneratePas sword  method  call.  As  one  would  assume,  Load  uses  ReadFile  calls, 
whereas  Save  uses  WriteFile  calls.  For  easier  loading  and  saving  of  strings  from  and 
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to  disk,  the  SCmd  structure  features  Readstring  and  Wri testring  methods  which  are 
invoked  similar  to  ReadFile  and  WriteFile. 

All  case  branches  refer  to  the  according  entries  in  the  program  command 
database.  Any  addition  or  change  to  it  might  also  require  changes  to  SCmd  structure 
members  Load,  Save  and  Execute.  A  database-independent  implementation  would 
have  been  too  complicated. 

For  some  commands  it  is  necessary  to  provide  an  additional  structure  as  parameter 
whose  pointer  is  stored  in  the  scmd  member  ptr.  Therefore,  all  type  definitions  in 
Gnd .  h  starting  with  TQ_  define  which  structures  may  be  used  for  this  purpose.  So  far,  the 
SCmd  structure  itself  can  be  used  (for  the  add_command  PCL  command)  as  well  as  the 
yet  to  be  defined  STask  and  SOSParams  structures. 


CPtrArrayc  struct  SMacro  Pointer  To 


Figure  15:  Implementation  principle  of  the  SMacro  and  SCmd  structure 

Figure  1  shows  how  the  SMacro  and  SCmd  structure  is  implemented  into  the  rest 
of  the  application  environment.  The  highest  level  of  the  hierarchy  consists  of  a 
CPtrArray  in  which  pointers  to  SMacro  structures  are  stored.  The  CDocument-derived 
class  in  groundstation  contains  two  of  them: 

•  CPtrArray  c  (for  command).  This  CPtrArray  contains  the  pointers  to  all  SMacro 
structures  necessary  to  hold  all  PCL  commands  and  their  parameters  which  are 
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accessible  from  within  the  groundstation  application.  Currently,  every  groundstation 
accessible  macro  consists  of  just  one  command,  but  as  it  is  a  SMacro  macro,  it  could 
hold  multiple  commands  with  no  additional  programming  necessary. 

•  CPtrArray  m  (for  macro).  This  class  contains  the  pointers  to  all  SMacro  structures 
used  for  the  macro  feature  of  the  groundstation.  This  feature  enables  the  user  to 
define  and  execute-by-click  commonly  used  macros. 


As  described  above,  the  scmd  member  ptr  points  to  a  memory  block  or  structure 
as  defined  in  the  program  command  database  by  the  type  qualifier  TQ_  -  #define’s 
(located  in  Gnd.h).  Because  this  type  qualifier  is  stored  in  the  program  command 
database,  all  the  programmer  has  to  know  is  the  command  ID  of  the  desired  command  to 
find  out  about  the  correct  memory  block  or  structure  to  be  referenced  by  ptr.  This 
determines  in  all  cases  how  to  handle  the  PCL  command,  its  parameters  and  return 
values,  if  applicable. 

3.  The  PCL  Input  Structure 

The  PCL  input  structure  SReturnCmd  is  declared  as 

struct  SReturnCmd 
{ 

_ ^intS  cmd ; 

_ inti 6  size; 

void  *ptr ; 

} ; 

This  will  allow  every  data  structure  to  be  downlinked  from  PANSAT  not  to 

exceed  65535  b)d;es.  The _ int8  cmd  contains  the  command  identifier  according  to  the 

program  command  database  and  indicates  the  PCL  command  whose  receipt  made 
PANSAT  downlink  a  portion  of  data.  Before  sending  the  actual  data,  PANSAT  sends  the 

length  of  that  data  as  a  16-bit-value  which  can  be  stored  in inti  6  size.  This 

information,  together  with  the  command  identification  and  the  program  command 
database,  enables  the  grovmdstation  software  (the  SReturnCmd  members,  in  this  case)  to 
determine  how  the  following  data  portion  downlinked  from  PANSAT  shall  be 
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interpreted.  The  structures  SRFile,  SRCommandBuffer,  SRTask,  SREvent, 
SRTelemetry  and  SROSParams  are  declared  to  serve  as  containers  for  that  downlinked 
data.  When  extending  or  changing  PCL,  it  might  be  necessasry  to  change  parts  of  those 
structures  or  add  new  ones.  You  should  comply  to  the  convention  of  naming  those 
structures  starting  with  SR  (Structure  Return). 

So  far,  any  implementation  of  the  input  structure  and  the  return  container 
structures  is  imdecided;  the  existing  structure  declarations,  however,  should  serve  as  a 
sensible  starting  point  for  further  development. 

Data  input  must  take  place  in  an  interrupt  procedure  because  the  groundstation 
software  cannot  constantly  poll  the  COM-port  when  expecting  an  answer  fi-om  PANSAT. 
In  Windows  terms,  interrupt  I/O  is  called  overlapped  I/O.  The  well-known 
CreateFile  method  features  overlapped  I/O  capability.  You  can  find  out  more  about 
the  appropriate  methods  in  [Ref  4]  and  [Ref  5].  After  reading  the  overview  of  these 
chapters,  you  should  learn  more  about  the  WaitConunEvent  function  next. 

4.  The  Evaluation  Process 

Because  every  implemented  method  cannot  completely  be  evaluated  for  correct 
functionality  yet  nor  is  all  coding  complete,  the  following  list  might  be  helpful  for 
programmers  who  need  to  continue  the  programming: 

•  Check  the  scmd  and  SMacro  structures  for  correct  disk  I/O  and  COM-port  access. 
Refer  to  the  contents  of  this  chapter  up  to  this  point  for  further  information  and 
references. 

•  Implement  overlapped  port  I/O  into  SReturnCmd  and  check  it  for  correct 
functionality.  You  might  have  to  use  small  additional  evaluation  programs  for  this. 

•  Learn  about  programming  WinWidgets  and  implement  the  functionality  for  all  tabbed 
dialogs.  Refer  to  the  “Groundstation  User’s  Manual”  for  how  these  tabbed  dialogs  are 
supposed  to  work.  Refer  to  “Using  WinWidgets’  Tabbed  Dialog”  and  the  already 
implemented  functionality  for  the  Scripts  tabbed  dialog  for  how  to  program  tabbed 
dialogs  and  WinWidgets  visual  controls. 
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•  Leam  more  about  ODBC-compatible  programming  in  order  to  store  all  downlinked 
telemetry  in  this  format.  Refer  to  [Ref  7]  for  complete  information  and  [Ref  8, 
Chapter  24-27]  for  a  sample  ODBC-compatible  application. 

•  Implement  additional  script  language  features.  Programming  the  GUI  might  have 
given  you  the  appropriate  information  to  continue  development. 


B.  PROGRAMMING  TECHNIQUES  USED  FOR  THE 
GROUNDSTATION 

The  following  is  a  short  description  of  important  programming  techniques  which 
were  used  to  program  the  groundstation.  This  description  could  be  very  useful  both  for 
understanding  how  the  groundstation  software  has  been  implemented  and  as  a  reference 
for  your  own  programming.  I  chose  the  topics  in  order  to  provide  an  independent  and 
reusable  overview  of  a  section  of  code. 


Tabi 


Tab2 


Tabs 


This  is  a  sample  tabbed 
dialog  with  3  tabs 


Figure  16:  A  sample  tabbed  dialog 


1.  Using  WinWidgets’ 
Tabbed  Dialog 

This  section  describes  how  to 
implement  the  very  useful  tabbed  dialog 
as  part  of  the  WinWidgets  Custom 
Control  package.  Refer  to  [Ref.  9]  for 
further  information.  A  tabbed  dialog 


looks  like  Figure  16.  It  consists  of  one  outer  dialog  and  three  inner  dialogs  (for  this 
example;  one  outer  dialog  may  contain  more  inner  dialogs).  The  outer  dialog  is  derived 
fi'om  the  WW  class  CTabDlg,  whereas  the  irmer  dialogs  are  derived  from 
CTabDlgChild.  As  a  summarization  of  [Ref  9],  follow  these  steps  to  create  and 
implement  a  tabbed  dialog  with  WW; 
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•  Create  each  inner  dialog  and  the  outer  dialog  with  AppStudio  (not  RW!)  as  separate 
dialogs. 

•  Use  ClassWizard  to  create  a  new  class  for  every  inner  and  the  outer  dialog.  Use 
CDialog  as  the  base  class.  Refer  to  [Ref.  10]  regarding  how  to  use  ClassWizard. 

•  For  the  groundstation  application  view  class  declaration  (recommended,  GndView .  h 
in  this  case),  insert  the  following: 


class  CGndView  :  pviblic  CView 
{ 


*in 

m 


m 


public : 

CMainTabDlg 
CCHScriptsDlg 
CCHTelemetryDlg 
CCHMailDlg 
CCHMemoryDlg 
CCHControlDlg 
CCHOSControlDlg 
CCHFileSystemDlg 
CCHTaskControlDlg  m 


m 


pTabDlg; 
ChDlgO ; 
ChDlgl ; 
’chDlg2  ; 
ChDlgS ; 
’chDlg4  ; 
ChDlgB ; 
ChDlgS; 
ChDlg? ; 


//  derived  from  CTabDlg 
//  derived  from  CTabDlgChild 


} 

•  In  each  *.cpp  source  and  *.h  header  file  created  with  ClassWizard,  replace  every 
occurrence  of  CDialog  with  either  CTabDlg  (for  the  outer  dialog)  or 
CTabDlgChild  (for  the  inner  dialogs).  Rebuild  the  *.clw  ClassWizard  database  file 
so  ClassWizard  can  recognize  the  new  WW  classes. 

•  Program  all  dialog  characteristics  using  the  PreSetTabCtrlxxx  and 
PreCreateTabCtrllnit  methods  according  to  [Ref.  10],  if  applicable,  and 
encapsulate  all  dialog  specific  processing  in  the  appropriate  dialog  class. 

•  Add  the  display  code  into  your  view  class  implementation  file  (recommended;  in  this 
case,  in  GndView .  cpp).  Use  the  CTabDlg:  :AddChildDialog  method  to  attach 
every  inner  dialog  to  the  outer  dialog.  Invoke  the  CTabDlg:  :DoModeless  method 
for  a  modeless  display  of  the  tabbed  dialog  (recommended).  Define  a  view  member 
variable  (m_bTabDlgUp)  to  determine  whether  the  tabbed  dialog  has  already  been 
instantiated. 
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void  CGndView: :OnUserAccess 0 

{ 

if  ( !ni_bTabDlgI^) 

{ 

m_pTabDlg  =  (CMainTabDlg*)  new  CMainTabDlg  (this)  ; 
//  add  child  tabs  to  tab  dialog  internal  list 
in._pTabDlg->AddChildDialog  (CCHScriptsDlg:  :  IDD , 
(CTabDlgChild  *) &m_ChDlgO) ; 
m_pTabDlg->AddChildDialog(CCHTelemetryDlg: : IDD, 
(CTabDlgChild  *) &m_ChDlgl) ; 
ni_pTabDlg->AddChildDialog  (CCHMailDlg :  :  IDD , 

( CTabDlgChi  Id  * )  &in_ChD  lg2 )  ; 
in_pTabDlg->AddChildDialog (CCHMemoryDlg: : IDD , 
(CTabDlgChild  *) &m_ChDlg3) ; 
in_pTabDlg->AddChildDialog (CCHControlDlg: : IDD , 
(CTabDlgChild  *) &m_ChDlg4) ; 
in_pTabDlg->AddChildDialog(CCHOSControlDlg: ; IDD, 
(CTabDlgChild  *) &m_ChDlg5) ; 
m_pTabDlg->AddChildDialog (CCHFileSystemDlg: : IDD , 
(CTabDlgChild  *) &m_ChDlg6) ; 
in_pTabDlg->AddChildDialog (CCHTaskControlDlg: : IDD , 
(CTabDlgChild  *) &m_ChDlg7) ; 

//  fire  off  tab  dialog 

in_pTabDlg->DoModeless (CMainTabDlg: :IDD,  this) ; 
m_bTabDlgUp  =  TRUE; 

} 

} 


The  destruction  could  look  somewhat  like  this: 
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CGndView: : "CGndView ( ) 
{ 


//  destroy  tabbed  dialog 
if  (m_bTabDlgUp) 

{ 

m_pTabDlg->DestroyWindow  0  ; 
delete  m_pTabDlg; 
in_bTabDlgUp  =  FALSE; 

} 

} 

•  There  are  also  three  notification  messages  for  handling  the  creation,  activation  and 
deactivation  of  the  child  (inner)  dialogs.  Refer  to  [Ref  9]  and  the  TABDEMO  sample 
application  provided  with  the  WinWidgets  package. 

2.  Using  WinWidgets’  HotLink 

Refer  to  [Ref.  11,  Hot-Linking  the  WinWidgets  to  Data  and  Connecting  the 
WinWidgets  to  Data]  for  detailed  information.  HotLinking  is  WinWidgets’  capability  to 
automatically  update  certain  data  types  as  a  result  of  a  user  modifying  certain  visual 
controls.  The  advantage  of  using  HotLinking  instead  of  installing  a  message  handler  is 
that  it  takes  less  progranoming  effort  to  settle  it.  If  you  wanted  to  change  the  contents  of  a 
variable  according  to  a  user  click,  you  normally  would  have  to: 

•  write  a  message  handler  into  a  window  function, 

•  attach  the  window  function  to  a  visual  control  via  a  message-map  entry,  and 

•  expand  the  class  declaration  with  an  afx_iiisg  entry  of  that  window  function. 

For  small  changes  like  changing  just  one’s  variable  contents  this  would  be  too 
much  programming  effort.  WinWidgets  allows  HotLinking  (under  certain  restrictions 
depending  on  the  type  of  the  variable)  using  the  WW  SetDataLink  method  as  shown: 
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WORD  m  hlEditMode; 


BOOL  CCHScriptsDlg:  ;  OnInitDialogO 
{ 

CHBRadio  *pEditMode 

(CHBRadio  *)  GetDlgltem  (IDC_SCRIPT_NORMALEDIT)  ; 
pEditMode->SetDataLink (TRUE ,  &m  hlEditMode) ; 


} 


3.  Using  *.ini  Files 

The  concept  of  *.ini  files  allows  applications  to  save  user-definable  data  as 
ASCII-text  to  a  file  with  an  *.ini  extension  located  in  the  SYS:\Windows  (or 
SYS :  \winNT35)  drawer.  This  data  can  refer  to  a  recently  used  file  list,  shown  dialogs,  or 
some  kind  of  preferences  the  user  does  not  want  to  define  over  and  over  again  every  time 
he  launches  the  application.  Thus,  use  of  *.ini  files  makes  application  handling  easier  and 
more  convenient  for  the  user. 

Windows  offers  basically  two  functions  which  support  *.ini  file  handling: 
GetProfileString  and  WriteProfileString,  both  encapsulated  in  the  MFC 
CWinApp  class.  Refer  to  [Ref.  12]  for  a  detailed  description  of  these  functions.  For  the 
groundstation  application,  this  *.ini  file  feature  is  implemented  as  shown  in  the  following 
code  segments: 
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in  Gnd . cpp : 

CGndApp : : CGndApp ( ) 

{ 

m_pszAppName="PANSAT  Ground  Station"; 
ni_pszProf ileName="Gnd.  INI"  ; 


in  Gndview.cpp: 

CGndView : ; CGndView ( ) 

{ 

int  i ; 

strSectionDir  =  "Directories"; 
strSectionExt  =  "Extensions"; 
strSectionDscipt  =  "Descriptions"; 


CGndApp  *pApp  =  (CGndApp  * ) Af xGetApp ( ) ; 


for  (i=0;  i<MAXDIRS;  i++) 
{ 


} 


PFI[i] .Dir  =  pApp-> 

GetProfileString (strSectionDir,  def[i]) ; 
PFI[i] .Ext  =  pApp-> 

GetProfileString (strSectionExt,  def[i]) ; 
PFI[i] .Des  =  pApp-> 

GetProf ileString (strSectionDscrpt ,  def [i] ) 


} 


First,  Windows  has  to  know  about  the  full  name  of  the  *.ini  file.  The  constructor 
of  the  application  class  is  a  good  place  to  define  it  (the  name  is  Gnd.  ini  for  this 
application).  To  retrieve  data  from  that  file  (assuming  we  already  have  meaningful  entries 
in  it),  the  GetProfileString  method  is  used.  The  strxxx  variables  are  MFC 
CString  class  instances  in  which  you  can  store  strings  (see  below  “MFC  Class 
CString”).  In  order  to  access  the  CWinApp-derived  class  of  your  application,  its  pointer  is 
retrieved  and  stored  in  pApp.  GetProfileString  takes  two  strings  as  parameters:  first, 
the  name  of  the  section,  and  second,  the  name  of  the  entry  as  used  in  Gnd.  ini.  The 
return  value  is  the  specific  string  referred  to  by  those  two  parameters.  The  following 
declarations  and  definitions  provide  this  functionality: 
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in  Gnd.h: 

struct  PANSATFileInfo 

{ 

CString  Dir; 

CString  Ext; 

CString  Des; 

}; 


const  static  char  *def[]  =  {"Script",  "Macro",  "Telemetry", 

"Userlog" ,  "Task" ,  "In" , 

"Out" } ; 

const  static  int  MAXDIRS  =  sizeof (def ) /sizeof (char  *) ; 

in  Gndview.h: 

CString  strSectionDir ; 

CString  strSectionExt; 

CString  strSectionDscrpt ; 

struct  PANSATFileInfo  PFI [MAXDIRS] ; 


With  the  above  code,  the  following  Gnd.  ini  file  can  be  read  by  the  application: 
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[Extensions] 
Script=* . PSF 
Macro=* .  GMD 
Telemetry=* . TMY 
Userlog=* . USL 
Task=* . PTL 
In=* . IN 
Out=*.OUT 


[Directories ] 

Script=D : \Ground\Script 
Macro=D : \Ground\Macro 
Telemetry=D : \Ground\Telmetry 
Userlog=D : \Ground\Userlog 
Task=D : \Ground\Task 
In=D : \Ground\lN 
Out=D : \Ground\OUT 

[Descriptions] 

Script=PANSAT  Script  File 
Macro=Macro  Definition 
Telemetry=Telemetry  Data 
Userlog=User  Log 
Task=PANSAT  Task  List 
In=IN  Data 
Out=OUT  Data 

Everything  on  the  right  side  of  the  equal  sign  is  stored  into  the  appropriate 
members  of  the  PFI  structure.  In  case  you  want  to  store  to  instead  of  retrieve  data  from 
the  Gnd .  ini  file,  use  code  as  shown  below: 
int  i; 

for  (i=0;  i<MAXDIRS;  i++) 

{ 

pApp->WriteProfileString(strSectionDir ,  def [i] ,  PFI [i] .Dir); 

} 


This  writes  MAXDIRS  entries  from  the  PFi  [  ]  .  Dir  string  array  after  the  equal 
sign  following  the  string  referred  to  in  def  []  in  the  [Directories]  section  of  the 
Gnd.  ini  file.  The  sequence  of  strings  in  the  Gnd.  ini  file  does  not  necessarily  have  to 
be  in  the  same  order  as  the  strings  in  the  PFI[]  .Dir.  The  xxxProfileString 
functions  will  always  resolve  to  the  entry  according  the  string  defined  by  def  [  ]  (for  this 
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example),  not  its  index.  This  makes  it  even  more  convenient  for  the  programmer  to  make 
use  of  *.ini  files.  With  the  MFC  cstring  class  both  the  use  and  the  programming  of 
*.ini  files  becomes  a  comparably  easy  task  to  accomplish. 

4.  MFC  Class  CString 

The  purpose  of  the  MFC  helper  class  cstring  is  to  simplify  both  memory 
allocation  and  string  alteration.  Refer  to  [Ref  13]  for  a  full  description  and  explanation  of 
the  very  useful  methods  of  this  class. 

Why  use  a  special  class  for  strings  when  C/C-H-  already  offers  char 
string  [n]  s?  Because  those  variables  are  of  fixed  length,  whereas  cstring  instances 
may  dynamically  vary  in  length.  This  relieves  the  programmer  from  the  repetitive  and 
error  prone  task  of  checking  for  string  boundaries,  memory  availability  and  dynamic 
memory  allocation  procedures  and  maintenance  routines.  With  cstrings,  none  of  these 
tedious  operations  need  to  be  coded  by  the  programmer.  Overridden  operators  such  as  =, 
+,  +=  allow  easy  assignment  and  concatenation  of  strings  to  cstring  objects. 
Extraction  and  conversion  routines  make  string  alteration  easy,  as  well  as  methods  for 
comparing,  searching  and  archiving  strings. 

The  use  of  cstring  objects  instead  of  char  strings  is  strongly  recommended. 
Try  to  replace  every  occurrence  of  the  old-fashioned  array  of  char  by  a  cstring  object 
unless  you  definitely  do  not  intend  to  change  either  the  length  or  the  contents  of  the 
string. 

5.  MFC  Class  CPtrArray  and  its  Neighbors 

In  almost  every  application  you  will  encoimter  the  problem  to  store  data  structures 
and  erase  or  edit  some  or  all  of  them.  Normally,  it  will  not  be  known  how  many  instances 
of  a  particular  data  structure  are  needed  during  development  or  compilation  time. 
Memory  as  well  as  performance  constraints  thus  will  lead  to  a  dynamic  allocated  and 
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released  system  of  data  structures.  This  will  probably  include  linked  lists  and  many 
pointers.  However,  this  task  can  be  left  to  one  of  the  various  MFC  CPtrArray  classes 
and  its  neighbors.  Learn  more  about  CPtrArrays  from  [Ref  14].  Refer  to  a  description 
for  “Collection  Classes”  (a  CPtrArray)  in  the  same  manual. 

What  kind  of  class  is  the  best  for  your  specific  data  structure  storage  problem? 
The  answer  to  this  question  can  only  be  found  in  your  specific  data  structures  and  the 
needs  imposed  on  your  code  to  behave  correctly.  A  short  overview  might  be  of  assistance 
when  browsing  through  the  help  files  for  Collection  Classes.  There  are  three  basic  ways 
of  data  storage  supported  by  those  classes;  however,  one  thing  is  common  to  all  of  them: 
the  programmer  never  has  to  worry  about  memory  allocation  or  deallocation.  The  three 
different  kinds  of  storage  are: 

•  The  array.  It  will  behave  like  a  zero-based  C  array,  its  members  thus  are  accessable 
by  their  index.  The  array  itself  will  grow  or  shrink  as  items  are  added  or  removed. 
The  array  can  contain  bytes,  words,  doublewords,  strings,  generic  pointers  and  more 
variable  types. 

•  The  list.  It  will  behave  like  a  doubly-linked  list  in  C.  The  list  can  contain  strings, 
generic  pointers,  pointers  to  CObject  classes  and  other  variable  types. 

•  The  map.  This  involves  variable  types  called  elements  which  are  values  you  attached 
a  unique  key  to.  Every  value  then  is  referenced  by  its  key.  Every  map  collection  class 
is  named  CMapXXXToYYY,  where  xxx  represents  the  key  and  yyy  the  value 
referenced  by  the  key. 

you  The  use  of  one  or  more  of  these  collection  classes  is  highly  recommended 
because  they  will  make  programming  of  arrays,  lists  and  mappable  variables  significantly 
easier.  Spend  one  hour  to  get  familiar  with  these,  and  save  many  more  while 
programming  them. 

C.  BUG  REPORT 

This  is  a  somewhat  arbitrary  collection  of  bugs,  programming  errors,  runtime 
failures  and  other  nasty  problems  that  could  happen  to  your  application  while  developing. 
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They  might  considerably  help  locating  bugs  in  a  matter  of  minutes  rather  than  days  or 
even  weeks.  I  would  personally  suggest  that  you  write  down  the  bugs  YOU  encountered 
for  your  personal  records:  including  a  short  note,  a  description  of  the  error  and  your 
workaroxmd  or  whatever  was  helpful. 

Nobody  does  it,  everybody  should:  use  commentsl  If  you  plan  to  develop  an 
application  for  more  than  three  weeks,  you  should  comment  your  source  files  as  precisely 
as  you  can.  I  can  assure  you  would  REALLY  regret  it  after  two  months  of  development. 
Trust  me!! 

For  further  specific  information  on  a  topic  check  [Ref  6]  and  browse  through  the 
headings. 


1.  Mysterious  Syntax  Errors  While  Using  #define’s 

You  might  want  to  check  if  you  terminated  your  #def  ine’s  with  a  semicolon;  if 
so,  delete  the  semicolon.  Otherwise  you  will  get  error  messages  like 


error  C2143:  syntax  error  :  missing  ')'  before  ' ; ' 

error  C2059:  syntax  error  :  ') ' 

error  C2181:  illegal  else  without  matching  if 


2.  Access  Violations  Due  to  Bad  Memory 

This  occurs  most  likely  not  because  of  defective  RAM,  but  because  you  forgot  to 
allocate  memory  for  your  object.  This  is  not  as  obvious  as  it  normally  should  be, 
especially  when  memory  allocation  is  hidden  somewhere  in  the  fi:amework. 

Example:  you  created  an  AppWizard-application  and  tried  to  access  CDocviment- 
derived  class  members  from  within  the  cview-derived  class  constractor.  This  will  fail 
somewhere  in  the  framework  source  files  with  an  Access  Violation,  failed  assert 


67 


statements  or  other  error  codes  related  to  CDocument-derived  class  access,  or,  in  the 
worst  case,  during  runtime  with  a  system  crash. 

The  application  does  not  run  anymore  because  at  the  time  the  cview-derived 
class  constructor  is  running,  the  CDocument-derived  class  is  not  yet  created  in  memory. 
Thus,  your  code  in  the  constructor  relying  on  an  existing  CDocument-derived  class  just 
accesses  random  memory  addresses,  and  fails  somewhere  when  the  randomly  accessed 
memory  contents  does  not  make  sense  any  more.  This  normally  occurs  quickly,  but 
former  CDocument  instances  could  mislead  your  application,  so  you  might  encounter 
randomly  running  and  crashing  application  behaviour. 

This  is  a  very  ugly  thing  when  it  happens,  so  how  do  you  find  out  about  it 
beforehand?  Normally,  you  will  not  be  able  to  prevent  yourself  from  programming  such  a 
nasty  bug,  unless  you  know  exactly  when  classes  are  instantiated  relative  to  others.  This 
information  is  hidden  sometimes  in  the  Overview  or  General  Information  section  in  the 
online  help  for  classes,  but  more  often  you  will  not  find  anything  about  it  there.  If  so, 
look  at  the  methods  provided  with  these  classes,  and  you  will  find  one  or  more  names 
indicating  an  initialization  or  presetting  of  member  variables  or  class  structures.  Read  the 
help  text  for  those  methods,  and  most  likely  you  will  find  sentences  like  “This  function  is 
invoked  after  XYZ  has  been  constructed,  but  just  before  ABC  is  shown.”.  The  best  place 
to  look  for  such  a  method  is  to  browse  through  the  class  “Initialization”  and 
“Overridables”  section.  If  this  explanation  sounds  like  a  solution  to  your  problem 
(remember,  you  do  not  really  know  why  your  application  crashes  all  the  time,  you  are  just 
poking  around  suspiciously),  just  put  those  lines  of  your  code  which  you  expect  to  be  the 
faulty  ones  (again,  another  thing  to  figure  out)  in  an  overridden  instance  of  that  specific 
method.  This  will  clear  everything  after  just  minutes  of  work,  if  you  guessed  everything 
right.  And,  in  the  future  you  will  be  wiser. 
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3.  AppWizard  Does  Not  Recognize  Your  Classes 

This  is  a  problem  that  occurs  sometimes  when  classes,  which  are  not  part  of  MFC 
or  MFC  derived  classes,  are  used.  In  this  case,  delete  the  *.clw  file  from  your 
development  directory.  All  information  that  describes  how  Class  Wizard  needs  to  perform 
its  actions  is  stored  in  this  *.clw  file.  Before  you  can  run  ClassWizard  again,  the  database 
must  be  reconstructed.  This  takes  only  a  few  seconds  and  could  be  achieved  by  following 
two  steps:  first,  open  the  *.rc  resource  file  from  within  the  Visual  Workbench.  The 
MSVC  built-in  dialog  editor  AppWizard  starts  up  and  processes  your  resources.  From  the 
main  menu,  choose  Project/ClassWizard  and  affirm  the  upcoming  dialog  box.  Then 
a  dialog  box  with  the  current  project  files  comes  up.  You  may  specify  additional  source 
files  whose  contents  you  wish  to  be  recognized  by  ClassWizard,  but  normally  you  just 
affirm  the  default  settings.  After  that,  the  *.clw  ClassWizard  database  is  regenerated,  and 
it  now  contains  all  class  information  including  even  the  non-MFC  classes  and  their 
derivatives. 

Sometimes  you  might  not  be  able  to  use  the  ClassWizard  Message  Map 
maintaining  feature;  ClassWizard  does  not  offer  Add  Function  for  previously  defined 
visual  controls,  even  if  you  rebuilt  the  *.clw  database  file  like  described  above.  If  so,  you 
have  to  manually  implement  all  the  changes  ClassWizard  would  have  done  for  you 
automatically  (described  in  “Using  ClassWizard  to  Change  Your  Application”). 

4.  Globally  Defined  Variables  Are  Not  Recognized 

You  might  encounter  the  problem  that  your  globally  defined  variables  are  not 
recognized  in  classes  you  added  to  the  project,  even  though  you  tinclude’d  every 
necessary  file  into  the  class  implementation,  and  neither  the  compiler  nor  the  linker 
complained  about  undefined  variables.  This  seems  to  be  a  compiler  problem;  however,  I 
never  experienced  it  before  I  started  developing  the  groundstation  application. 
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How  do  you  leam  about  this  error?  The  compiler  and  linker  know  about  the  global 
variable,  but  during  runtime,  just  another  address  is  resolved.  This  results  in  unexpected 
program  behaviour  of  some  kind  related  to  that  global  variable  -  nothing  new  during  the 
development  phase.  That  this  error  exists  can  usually  easily  be  discovered  by  invoking 
the  QuickWatch  feature  while  debugging  the  program  (Debug/QuickWatch  or  Shift-F9 
with  cursor  over  the  variable  in  question,  or  typing  it  in  into  the  upcoming  dialog  box). 

The  solution  is  easy:  define  a  member  variable  of  the  same  type  (or  a  pointer  to  it) 
in  the  class  in  which  you  want  to  use  the  inaccessible  global  variable,  and  set  it  to  the 
value  (or  the  address,  in  case  of  a  pointer  variable)  of  the  global  variable  from  within  your 
cview-  or  CFrameWnd-derived  class  of  the  application. 
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VI.  CONCLUSION 


This  thesis  demonstrates  that  software  development  of  a  complex  Windows-based 
application  could  be  accomplished  with  satisfying  results.  For  the  implementation  of  the 
complete  functionality  of  the  PANSAT  Software  Groundstation,  however,  further 
development  will  be  necessary.  This  thesis  does  not  only  discuss  the  Software 
Groimdstation,  but  also  provides  the  reader  with  the  information  necessary  to  develop 
other  Windows-based  C-H-  applications  using  MS  VC  and  the  various  additional  tools. 

Software  development  is  a  delicate  task.  Poor  conceptual  design  in  the  beginning 
can  result  in  disastrous  conditions  during  and  after  development.  That  is  why  most  of  the 
time  and  effort  should  be  spent  in  defining  the  appropriate  data  structures  and  the 
conceptual  design.  Most  often,  errors  because  of  poor  conceptual  design  can  only  be 
corrected  with  a  vast  amount  of  time  and  manpower  (that  is,  money),  if  at  all.  Thus,  a 
certain  portion  of  detail  must  be  provided  during  this  phase,  otherwise  the  effort  will  be 
worthless. 

This  thesis  also  shows  that  software  development  will  soon  become  a  team  effort, 
once  the  conceptual  design  reaches  a  certain  complexity.  Although  only  one  person  may 
actually  code  the  program,  he  will  be  dependent  on  the  technically  funded  inputs  of  his 
co-workers,  as  software  usually  puts  a  multitude  of  engineering  tasks  in  one  single 
environment. 
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VIII.  APPENDIX 


A.  APPLICATION  SOURCECODE 


Gndh 

Gnd.cpp 

GndDoc.h 

GndDoc.cpp 

GndView.h 

GndView.cpp 

MainFrm.h 

MainFrm.cpp 


Static  variables/data  structure  (SCmd/SMacro)  include  file 
Application  file  implementation  file 
Groundstation  Document  include  file 

Groundstation  Document  and  SCmd/SMacro  implementation  file 
Groundstation  View  include  file 

Groundstation  View/Message  Map  &  Handler  implementation  file 
Groundstation  Main  Frame  include  file 
Groimdstation  Main  Frame  implementation  file 


Gnd.h 

//  Gnd.h  :  irain  header  file  for  the  OSID  aFplicatioi 
// 

//  CAUTICN:  THIS  CCDE  lEEmCB  CN  int  BEING  4  BYTES  LONG! ! ! 

#ifndef  _AE)<WIN_H_ 

terror  ijnclude  'stdafx.h’  before  including  this  file  for  PCH 
tendif 

tinclude  "resource. h"  //  irain  syrrtols 

//////////////////////////////////////////////// 

// 

H  Cocrrxn  type  definitions  and  static  variables  for  the  vhole  Qnd-project 
// 

struct  PMSKTEilelnfo 
{ 

CString  Dir; 

CString  Ext; 

CString  Des; 

}; 
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struct  SUser 
{ 

char  login [20]; 
char  passw[12]; 

int  flags;  //  see  #de£me's  below 


//  declaration  of  the  Syfecro  structure 

struct  Syfecro  //  A  Lfecro  definition.  Every  carrnand  can  be  regarded  as  a  itacro. 

{ 

public:  //  ooistruotion/destruction 

ayJacro  ( )  ; 

Sl^fecro(int  nindex);  //  use  for  ooistruction  of  built-in  ocmnands 

Syfecro  (const  char  ^^pName);  //  use  for  cmstructicn  of  rtecros  (disk-stored  ccrnnands) 
virtual  -Syfecro  ( ) ;  //  frees  all  allocated  ireiory 

public:  //  public  menfoer  functions 
vii±ual  int  Load() ;  //  overload  this  iracro  vdth  a  new  one 

virtual  int  Save();  //  save  the  current  rracro  to  disk 
virtual  int  Overwrite  ();  //  overwrite  the  current  rracro  to  disk 
virtual  int  Execute  () ;  //  execute  the  iracro 

virtual  int  GetError  () ;  //  retrieve  nError  if  load  on  construction  is  used 
BOX  IsScriptO; 

protected:  //  protected  mertber  functions  and  merber  variables 
BOX  nUiHasChanged; 

int  nError;  //internal  error  if  load,  Save,  Execute  return  B?\LSE;  else  amount  of  bytes  read 
private:  //  mertber  functions  unique  to  St^cro 
const  ohar  ^GetELleNaireO ;  //  use  stropy(char  dest[256],  FJyfecro->GetEileName() )  ; 

BOX  SetFlleName  (const  char  *pName)  ; 
const  ohar  *GetDfecroName  ( )  ; 
void  Setl^crdName  (cxnst  char  *pName)  ; 
private:  //  data  itieitbers  unique  to  S^fecro 
CString  ELleName; 

CString  lyfecrcName; 

CPtrftrray  end;  //  pointer  to  the  iracro  Xtrftrray  structure  containing  SQtd  structures 
BOX  it^bHasEileName; 

BOOL  m_bIsBuiltIn; 

BOX  nUDlsScript; 

//  friend  classes  are, . . 
friend  class  OCHScriptsDlg; 

}; 


#define  NCERR  -1 

tdefine  EE^_FII£JOT_FO(M  0 

#define  EHl_FIIE_EXISrs  1 

#define  ERRJjQADING  2 

#define  ERR_SAVING  3 

tdefine  ERR  EXDCXTnNG  4 
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#defiiie  EE^JIl^/EEMOTING  5 

#define  ERRJ^0_FILENM:  6 

#define  ERE^OPEN_KB_WRITING  7 

#define  ERRJDEEN_EtSlJRE2y7ING  8 

#defiiie  muypEi^ijaRjymji^  9 

#defiiie  ERRjmiEJIHI?^^  10 

idefine  EE^JNVALID_EnJEl©3^  11 

tdefine  ERR  TEMP  DELEITCK  12 


const  static  char  *ErrAry[]  = 

{ 

"File  not  found!",  //O 
"File  already  exists!",  //I 
"Error  viiile  loading  macro  from  disk!"//2 
"Error  vMle  saving  iiHcro  to  disk! ",  //3 
"Error  viiile  executing  rracro!",  //4 
"Error  v^hile  overwriting  itacro  to  disk!",  //5 
"No  file  name  specified!",  //6 
"Couldn’t  cpen  nacro  file  for  output!",  //I 
"Couldn’t  open  macro  file  for  input!",  //8 
"Couldn't  q^en  execution  device!",  //9 
"Error  vdiile  trying  to  ctotain  the  macro  file  size ! ",  //lO 
"This  filename  is  invalid!",  //ll 
"Couldn't  delete  temporary  file!"  //12 
}; 


struct  SQrd  :  public  a^cro  //  SQnd  holds  oatTrand  and  data  info  for  output  to  EANSAT 
{ 

public:  //  constructor /destructor 
SQrdO; 

SCmd{int  nindex)  ; 

-SQrdO; 

public:  //  data  menbers 

int8  ord;  //  holds  oonmand  ID  according  to  DocQTd[]  .camand 

_intl6  wPararrv  //  holds  param  of  t^pe  q^edfied  by  TW_xxx  in  DocQid[]  .wParamJiype 
long  iParam;  //  holds  param  of  type  specified  by  TLxxx  in  DoaCitd[]  .IParamJType 
void  *ptr;  //  holds  a  generic  pointer  according  to  TQ_xxx-spec  in  DooQtd[]  .wParamJiype 

public:  //  public  member  functions,  overridden  from  SJfecro 
virtual  BOOL  Load(void  *fh) ;  //  load  a  occtmand  from  disk 

virtual  BOOL  Save  (void  *fh);  //  save  stored  oortmand  to  disk 

virtual  BOX  Execute  (void  *fh) ;  //  execute  this  ccrtitand 
protected:  //  protected  mertber  functions  and  member  variables 
virtual  long  GeneratePassrordO ; 

BOX  Readstring  (void  *fh,  long  *pLong,  int  *pnErr); 

BOX  WriteString(void  *fh,  char  *pchar,  int  *pnErr); 

}; 
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struct  SRetumQrd  //  SReturrOrd  holds  catnend  and  data  info  for  iiput  froti  ESNSftT 
_int8  otd;  //  holds  comend  ID  according  to  EocQtd[]  .amnand 

_:jatl6  size;  //  holds  size  of  the  vtole  data  stream  coning  back  or  artount  of  received  return  structures 

^^void  ^tr;  //  holds  a  generic  pointer  or  other  info  according  to  IR_x;«-spec  in  Docad(]  .retumJIVpe 


//  SDocumuentQnnd: 

//  Ihe  program  conrand  database.  Ihe  source  of  infonration  ocnoeming  ooimand  I/O  with  EANSflr, 
Struct  SEocurrientQrd  / /  holds  internal  cornrand  representatiai 
{ 

char  *catnand/  // plain  cxirmand  narre 
_ .^'^8  omdlD;  //  encoded  ccrarand  ID 

int  flags;  //  Super  User  Catnend,  Password,  user  acoessability 

int  wParamJI^;  //  defines  type  for  SQid.wParam 

int  iParamJType;  //  defines  type  for  SGrrd.lParam 

int  retumJType;  //  defines  return  type  for  SPetumQrd.ptr 


/////////// //////////// ////////////////////////////////////// 

//  parameter  structures:  Sxxx.  Send  this  stuff  up  TO  ESNSfiT' ' 

// 

struct  STask 
{ 

char  diskname,  //  filename  of  IHIS  task  on  disk;  not  to  be  sent  to  PANSAT 
char  *taskname;  //  taskname  in  PANSAT 
_int8  pri;  //  task  priority 
int  size; 

void  *data;  //  task  data  has  size  bytes 
public: 

STask  0  ; 

~STask(); 

}; 


struct  SCSParams 
{ 

//  tbd 
public: 

-SOSParamsO;  //  tbd 
SCSParams  {);  //  tbd 

}; 


//  reton  stmctores:  SRock.  CSDUOT:  ler^  of  structures  nust  be  ctetentunahle -  ■  • 
// 

struct  SRElle  //  holds  one  PANSAT  file 
{ 
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char  *naire;  //  EANSAT  file  name  has  strlen(name}  +  1  bytes 

void  *data;  //  file  data  has  (SReturnQrd.size  -  strlen(name)+l)  bytes 

}; 

struct  SBQtdBuffer  :  SQtd  //  holds  one  time  tagged  ocnnend  (that  is,  conmand  and 
^  //  its  pararreters,  planned  begin  of  executioi  time) 

long  tiite;  //  SQl™e™e:4 

}; 


struct  SPTask  //  holds  info  for  one  task  in  P^NSAT 

{ 

char  *narte; 

int8  cn; 

_intl6  status; 
intl6  pri; 

intl6  size;  //  size  in  bytes  of  PANSAT  task 


struct  SFEvent  :  SBQniBuffer  //  holds  cne  event  (that  is,  ocrtrtiand  and  its  parameters, 
^  //  begin  of  execution  time) 

}; 


struct  SPTelstetry 

{ 

//  tbd 

}; 


struct  SROSParams 
{ 

int  version; 
long  time; 
int  taskc; 
char  **tas]<v; 

}; 


//  SQm3EnME4 

//  =  n  =  #  of  entries  taskv[n] .  taskcrt'asKtounter,  taskv=TasXVector 
//  array  of  char  *  to  tasknames 


1 1  flags  for  SDocumentQtd  and  SUser:  CR  'em! 
#define  EN2S2  0x0000  H  No  reqirireitients  necessary 
#de£Lne  FERSS  0x0001  //  Password  required 


#define  EMMN  0x0002  //  must  be  achdmstrator  to  access  super  user  and  password  aids 

tdefine  ESOPER  Ox(X)04  //  must  be  si^er  user  to  access  all  Groundstaticn  aids 

#defme  EINIHi  0x0008  II  must  be  intermediate  user  to  access  aU  aids  exc^t  matory  and  lew-level 

Idefine  roOMB  0x0010  //  stupid  user  -  can  only  access  itail  ards 

#define  5ICL  0x0020  //  is  a  PCL  oemtand  {if  not  set:  is  a  Groundstation  use  oertmand) 


/////////////////////////////////////^/// /////// mm  n 

//  Types  of  parameters:  SDocumentQnri.xx_Type  identifier 
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// 

//  TW_xxx  and  TL_xxx  define  data  types  spearing  in  wParam  and  IParam  of  the  SQtd  structure  respectively. 

//  TWjooc  used  for  both  output  and  return  to/froca  PMSKT,  vhei^as  TL_xxx  is  used  only  for  output  to  . 

//  TQ_xxx  are  CB’ed  to  IWjqk  and  define  how  the  SQnd.ptr  matber  is  to  be  interpreted.  TQ_xxx  are 
//  only  used  in  the  output  structure  SQnnd. 

//  TRxxx  in  contrary  to  TQjooc  are  only  used  in  the  return  structure  SRetumCmd.  They're  also  CR'ed  to 
//  TWjok  to  define  the  SRetumQrd.ptr  generic  pointer  merrber. 


idefine  TVOID  QxOOOO  If  nothing  specified 
//  wParam  types:  max#:  256,  max  range:  0x0000.. OxFEPF 
//  Nuibers 

#define  'mjmm  0x0001  //  0.. 65535  size  of  object 
#define  TWJftIA  0x0002  //  0.  .QxFF  memory  contents 
#define  TW  CMD  0x0003  //  0.  .255  EANSfiT  ooiiTBnd  ID 


tdefine  TWJODE 
#define  TWJTTRL 
#define  TWJffiBLE 
#define  TW_IjEVEIj 
#define  TW  POWER 


0x0004  //  byte  length;  0x00=BPSK,  0xEP=SS 

0x0005  //  byte;  bin  xxOOOOOO.  .xxllllll  (dec  63)  transceiver  control  byte 
0x0006  If  tbd;  so  far  0..255 
0x0007  //  tbd;  so  far  0..255 
0x0008 


tdefine  TWVERSN  0x0009  //  tbd;  so  far  0. .255 

tdefine  TWJXONT  OxOOOA  //  0.  .200  amount  of  msri  to  be  read  fitting  into  cne  AX. 25  frame 


If  Type  qualifiers:  T2_xxx  (max#:  256)  to  be  CR'ed  with  one  of  the  TW_3yy  types 
//  Defines  the  contents  of  the  SQrd.ptr 

#define  T2_CiyDPrR  0x0100  //  SQnd.ptr  ccntains  a  pointer  to  an  SQnd  structure 

#define  TQ JOiBESS  0x0200  //  SQnd.ptr  coitains  a  pointer  to  n  bytes  (n:  to  be  CR'ed  with  this) 

#define  TQJEASKPTR  0x0300  //  SQnd.ptr  ccntains  a  pointer  to  an  STaskList  structure 

#define  TQJOSPTR  0x0400  //  SQnd.ptr  contains  a  pointer  to  an  SOSParams  structure 

#define  TQ_CHPTR  0x0500  //  SQnd.ptr  contains  a  pointer  to  a  C  string  (’\0’ --ended  string) 

#define  TQ_M?O0  0x0600  //  SQnd.ptr  contains  a  pointer  to  an  Sfecro  structure 


//  IParam  types:  itex#:  65536;  max  range:  0x00000000.  .OxFFFFETTF 
//  char  *,  Addresses,  Time 

#define  TMIHPrR  0x0001  //  pointer  to  a  C  string 
#define  TLJCBAIB  0x0002  //  0.  .OxFF  PCB  address 

#define  TL_RAMAm  0x0003  //  0..7FFEE  (dec  524287)  and  P0000..FEEFF  (dec  983040. .1048575)  RAXI/RCM  address 

#define  TL_SRAMAER  0x0004  //  0..0x3EEEEF  (dec  4194303)  SRAM  address 

Idefine  TLJISHATR  0x0005  //  0..Qx7FEFF  (dec  524287)  flash  irem  address 

#define  TLJCKEAER  0x0006  //  0..0xEFEF  (dec  65535)  CPU  I/O  port  address 

#define  TLJJIC  0x0007  //  4  byte  UIC  time/date,  equivalent  to  4  Byte  SQL  time/date 

//  SRetumQtd  return  type  qualifiers:  TR_xxx  (max#:  256)  to  be  CR'ed  with  one  of  the  TO^yy  types 

//  Defines  the  contents  of  the  SBeturnOnd.ptr  generic  pointer 

#define  TEWOBESS  0x0001  //  address  in  groundstatioi  oorputer  menriory 
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#define  TRJTTC  0x0002  //  S:iw:E:nmi 

#define  TR_CHPrR  0x0003  //  pointer  to  C  string 

#define  TT^FILEPTR  0x0004  //  pointer  to  struct  SREile 

#define  TR_ayiDPrR  0x0005  //  pointer  to  struct  SPQndBuffer 

idefine  TRJEASKPTR  0x0006  //  pointer  to  struct  SKTask 

tdefine  TRJEArarPIR  0x0007  //  pointer  to  struct  SREvent 

tdefine  TRjrELPTR  0x0009  //  pointer  to  struct  SKTelertetry 

#define  TRJOSPTR  0x0008  //  pointer  to  struct  SROSParams 


const  static  SDocumentQrd  DooQnd[]  = 

{ 


{"adijxnrtBnd" 

,  0x01,  FPCLIFSOBERIFPASS,  TVOID  [ 

TQ_ayDPrR  ,  tljjtc 

TVOID 

{"add_task” 

,  0x02,  FPCLfPSDPERIFRASS, 

TQjmSKPTR,  TVOID  , 

TVDID 

)f 

{"'boot_rcm” 

,  0x03,  EPCLIESUPERiEPASS,  TVDID 

,  TVOID 

TVOID 

{"charge J>att_a" 

,  0x04,  FPa|E30PER[PPASS,  TVOID 

,  TVOID  , 

TVOID 

{ "charge_batt Jd" 

,  0x05,  FPaiFSUPERlPPASS,  TVOID 

,  TVOID  , 

TVOID 

{ "deletejxctrtBnd” 

r  0x06,  FPCL|ESOPER|FPASS,  TW_CMD 

,  TLJJTC 

TVOID 

{"delete_file" 

r  0x07,  FPCLimmQ  ,  TVOID 

,  TLJCHPTR  , 

TVOID 

{"delete_task” 

,  0x08,  EECLIESDPERIFPASS,  TVOID 

,  ILJ^IPTR  , 

TVOID 

{"directory*' 

,  0x09,  FPaiENCREQ  ,  TVOID 

,  TVOID  , 

wjmmi 

TRJ^iPTR 

{ "discharge_batt_a" 

r  OxOA,  FPCLIESOPERIFPASS,  TVDID 

,  TVDID  , 

TVOID 

{ ''dischargejDattjD'' 

,  OxOB,  FPaiESUPERlFPASS,  TVOID 

,  TVOID  , 

TVOID 

{"drcpjjsers" 

,  OxOC,  FECL|FSUPER|EPASS,  TVOID 

,  TVOID 

TVOID 

{"get_file” 

r  OxOD,  r  TVOID 

,  TLJ3IFTR  , 

TR^ETLEPTR  }, 

{"io_read" 

,  OxOE,  FECLIHNCREQ  ,  TVOID 

,  TLJEQPTADR, 

TWJDATA  i 

TRjyjDRESS  }, 

{"io_write” 

,  OxOF,  HPCLIFSUPERIFRASS,  TWJftIA 

,  TLJCREam, 

TVOID 

{ ''listjcarriBndJxif fer'' 

,  0x10,  FPCLIFSUEERIFPASS,  TVOID 

,  TVOID 

TWjyyONTI 

TTUMDPTR 

{"list_tasks" 

,  0x11,  FPCLIFSUPERIFPASS,  TVOID 

,  TVOID  , 

TWjmJNTI 

TRJEASKPIR  }, 

{ "lockoutjjsers” 

r  0x12,  FPCLIESUEERIEPASS,  TVOID 

,  TVOID  , 

TVDID 

{"pcbr" 

r  0x13,  FPCLIEOTEQ  /  TVOID 

,  tl_pcbai:r  , 

TWJIftTA.  1 

TRMXRESS 

{"pcfaw” 

,  0x14,  FPCLIFSOPERIFPASS,  IW_EKm 

,  TLJCBm  , 

TVOID 

}r 

{ ''purgejooiriBndJouf fer'' 

r  0x15,  FraiFSUPERlFPASS,  TVOID 

,  TVOID  , 

TVOID 

{ "puige_event_log" 

,  0x16,  EraiESUPERiFRASS,  TVOID 

,  TVOID  , 

TVDID 

{ "purgejQlashjiata" 

.  0x17,  EECLIESUPERIFPASS,  TVOID 

,  TVOID 

TVOID 

{ "purge_storedJteleiretry" 

,  0x18,  PPCL|ESUPER[FEASS,  TVOID 

,  TVOID  , 

TVOID 

{"put^file" 

.  0x19,  FPCLIEWCRB2  , 

TQAIXRESS,  TLJCHPTR  , 

TVDID 

{"readjolock" 

,  OxlA,  FPCLIEraaO  ,  TVOID 

,  TVOID  , 

TRJJIC 

{ "read_eventJ.og" 

,  OxiJB,  EPCLIFSUPERIFPASS,  TVDID 

,  TVOID  , 

TWjmM’l 

TTJEVENTPIR} , 

{"read_flash_data" 

,  QxlC,  FPCLIEiraREP  ,  TVDID 

,  TVOID  , 

TRJTEUTR 

{ "read^flashjtem" 

-  OxlD,  FPCLIFNCREQ  ,  TWjmiOT 

,  TLJLSHArR, 

TWjmJNTi 

TR_AD[»ESS 

{ "readjDS_param" 

,  OxUE,  FPCLIENCRBQ  ,  TVOID 

,  TVOID  , 

TRJDSPTR 

{ "2:ead_reoent_tel€itEtry" 

,  OxlF,  EPCLIEOTHS  ,  TVOID 

,  TVOID  , 

TRJFELPTR 

}r 

{ "readjsrarnjnem" 

,  0x20,  F£CL\WBEQ  ,  TWjmJNT 

,  TL_SRfiMAm, 

TWjyyOJNTi 

TRJII3BESS 

}, 

{ "read_stored_teleiretry" 

,  0x21,  FPCLIENCMQ  ,  TVOID 

,  TVOID  , 

TRJELPTR 

}/ 

{"reset  watchdog" 

.  0x22,  FPCLIINCREQ  ,  TVOID 

,  TVOID 

TVOID 

{ "sel_trans_param" 

,  0x23,  F£CL\mOPEQ  ,  TWJTTRL 

,  TVDID 

TVDID 
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{ ”select_xraitmode” 

,  0x24,  FPCLIESUPEHIFEASS,  TWJO^ 

r 

TVOID 

TVOID 

}, 

{ "set_clock" 

,  0x25,  FKXIISUPEIllFPASS,  TVOID 

r 

TLJJDC  , 

TVOID 

{ "set_polling_rates" 

,  0x26,  FPCLIESOPERIFPASS,  IW_TABLE 

/ 

TVOID  , 

TVOID 

{ '’setj)cwer_jlevel" 

,  0x27,  FPaiESUPEUlFPASS,  IWJLEVEL 

t 

.TVOID 

TVOID 

{ "set_pwr_swLtch" 

,  0x28,  FICLIESOEERIFPASS,  IWJPOWER 

, 

TVOID 

TVOID 

{ "set_storage_rates" 

,  0x29,  FPCL|ESUEER[FEASS,  IWJEABLE 

t 

TVOID 

TVOID 

{"startjiask" 

,  0x2A,  FPaiFSUEERlEPASS,  TVOID 

t 

TL_CHPrR  , 

TVOID 

{"stepjask" 

,  0x2B,  FKXIESUFERlFPftSS,  TVOID 

, 

TL_CHPrR  , 

TVOID 

{"stop_wdog" 

,  0x2C,  FraiESUIERlFPASS,  TVOID 

r 

TVOID  , 

TVOID 

{ "unlock_iisers” 

,  0x2D,  FPCLI5SUPERIFPASS,  TVOID 

/ 

TVOID  , 

TVOID 

{ ”ipdatejos_param" 

,  0x2E,  FHXIESOPERIFPASS, 

T2_0SPIR  , 

TVOID  , 

TVOID 

}/ 

{ "write_f1  ashjnem” 

,  0x2F,  ETCLIENCREQ  , 

, 

'IT_FISHADR, 

TVOID 

{ ’’writejsrarajrBTi'’ 

,  0x30,  FPCL|FSUPER|FPASS,  TW_nm 

/ 

TL_SR?ayiADR, 

TVOID 

} 

{"readjnanory” 

,  0x31,  FPaiFNCPEQ  ,  TOJ^MDUNT 

/ 

TL_RAMADR  , 

TWjayaJNT  1 TRADDRESS 

{"write  memory” 

,  0x32,  FPCLiEio^  , 

TQ_ADDRESS, 

TL_RPMAER  , 

TVOID 

} 

*/ 

}; 

const  static  int  nSmountOrid  =  sizeof  (DocOnnd)  /sizeof  (SDoairentCmd)  ; 

//  the  following  #define's  allow  synbolic  access  to  all  ccnnHnds  via  their  0-based  index  entry  into 
//  the  main  CPtrArray  named  ends.  IXNT  MESS  WITH  THESE  EEFHsESI 


//  THEY  PERRESENT  THE  JWEX  IN  DocQnd[]  IM)  ARE  lATER  STCFED  INTO  CPtrArray  Macro! 

#defme  CM)_add_ccnnBnd 

0x00 

#define  CMD_addJtask 

0x01 

#define  CMD jDOot_rcm 

0x02 

tdefine  CMD_chargejDatt_a 

0x03 

#define  CMjchargejDattjD 

0x04 

#define  C^©Jdelete_ocIrrnand 

0x05 

idefine  CMD_delete_file 

0x06 

#define  CMD_deleteJ:ask 

0x07 

tdefine  CMDjdirectory 

0x08 

tdefine  CiyD_dischargejDatt_a 

0x09 

#define  CiyD_discharge_battjD 

OxOA 

#define  CMD  drop  users 

OxOB 

#define  CMD_5et_file 

OxOC 

idefine  CMDjLOjcead 

QxOD 

#define  CMD_iq_write 

OxOE 

#define  CMD_listjzccinerKlj3^ 

OxOF 

idefine  CMD_list_tasks 

0x10 

idefine  CMD  lockout  users 

0x11 

idefine  CMD_pcbr 

0x12 

idefine  CMD_p±w 

0x13 

idefine  O^^purgejxranrandJxiffer 

0x14 

idefine  CMD_purge_event_log 

0x15 
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#define  CMDjJurgeJ3.ash_data  0x16 

#define  CI®jxirge_storedJ:elemet^  0x17 
#define  CMD_put_file  0x18 

#defme  ayD_read_clock  0x19 

#define  a®j:ead_event_log  OxlA 

#define  CfyD_readj£Lashjdata  OxlB 

#defiiie  (:MD_readjQ.ashjren  OxlC 

#define  (MD_readjDS_param  OxlD 

#defijie  a®jcead_recmtj:elemetry  OxUE 
#define  ayD_read_srarnjrHri  QxlF 

#define  (M)ji:ead_stored_telertetry  0x20 
#defiiie  CiyDj:eset_watchdog  0x21 

#define  ayD_sel_trans_param  0x22 

#define  CDC)jselect_xiiatjr)ode  0x23 

#define  ayD_set_clock  0x24 

tdefine  (M)_setjx>lliiig_rates  0x25 

#define  CMD_setjpcfrrer_level  0x26 

#defiiie  CMDj5etjXftQ:_svdtch  0x27 

#define  CMD_set_storage_j:ates  0x28 

#define  CMD_start_task  0x29 

#define  CMD_stcp_task  0x2A 

#define  CM)_stcp_wiog  Qx2B 

#define  CMDjjnlockjasers  0x2C 

#define  CM5jpdate_os_param  0x2D 

#define  (»_writejElashnTan  0x2E 

#define  CI®j»^tejsram_mera  0x2F 

/* 

#define  CMD_read jtiemory  0x30 

#define  CLC)_writejriatory  0x31 

*/ 


#define  CiyDJ«MmiE 
#define  CMDjnacroOl 
#defiiie  CMDjnacro02 
#deflne  CMDjracro03 
#defiiie  C>C)jracro04 
#define  CMDxnacro05 
#define  CMDjnacro06 
#define  CMD_rtacxo07 
#define  CMDjtacro08 
tdefine  CI^jnacro09 
#define  ayDjracrolO 
#defijie  CMDjnacroll 
#defiiie  CMDrnaa:ol2 
#define  CMDjtBCxol3 
#define  CIC)_iTBcrDl4 
#define  CMD  nacrolS 


0x30  //  keep  this  aie  always  the  next  free  index! 

M)_NEXT_VAL0E 

cjyDj^ExrjmjE+2 

CMDj«r_\m}E+3 

CMlJ®Cr_VALCE+4 

cw)jJsyn:_ypijjE+e 

Q^j^Exrj7p;Lm+i 

CMlJSEXr_VmJE+8 

ci^jiExr_\mjE+9 

CI^J5EXrjZALUE+10 

a®jMTjm3E+ii 

cmjjExr_mjjE+u 

ayDj3EXTj/s^ 

OO  NEXT  VAlOE+14 
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struct  Sl^pePange 

{ 

int  typelD;  //  type  ID  (IWjkxx  and  TL_xxk,  see  above  tdefine’s) 

int  vartype/  //  variable  type  (Vxxx,  see  #define's  belcw) 

long  lew;  //  valid  range  for  specified  typelD: 

long  hi^;  //  -  if  vartype=VNUiyiBER,  VM)DRESS:  lew,  hic^  :  lewest/hi^est  nurrber, 

long  xlcw;  //  xlcw,  xhi^:  except,  but  not  including,  that  range 

long  xhi^;  II  -  if  vartype==VSTRING:  lew:  max  string  length  (including  \0) 

//  -  if  vartype=====vnME:  no  built-in  restrictions 

}; 

//  variable  types:  STypePange. vartype _ 

#define  VTJIMER  0x01 
#define  VTjmRESS  0x02 
#define  VT_STRING  0x03 
#define  VTjmyE  0x04 

const  static  STypePange  TypePange[]  = 

{ 

{  IWJMXKT  ,  Vr_NUMBER  ,  0,  OxFFEF,  0,  0  }, 

{  IVnOKrA  ,  VT_MJMBER  ,  0,  OxFF  ,  0,  0  }, 

^  {  IW_CMD  ,  Vr_NaMBER  ,  0,  OxEF  ,  0,  0  }, 

{  IWJO^E  ,  VTjraMBER  ,  0,  OxEF  ,  0,  OxFF}, 

{  TWJDTRL  ,  VTJCMBER  ,  0,  0x3F  ,  0,  0  }, 

{  T^JpELE  ,  VTJSIUMBER  ,  0,  OxFF  ,  0,  0  }, 

{  IWJEVEL  ,  VTJdMBER  ,  0,  OxFF  ,  0,  0  }, 

{  TWJOWER  ,  VTJCIMBER  ,  0,  OxFF  ,  0,  0  }, 

{  ,  VT_NUMBER  ,  0,  OxFF  ,  0,  0  }, 

{  IWJXlUNr  ,  VTJWER  ,  0,  0xC8  ,  0,  0  }, 

{  TL^GHPTR  ,  VTJWBESSr  0,  0  ,0  ,0  }, 

{  ILECBADR  ,  VTJWBESS,  0,  OxFF  ,0  ,0  }, 

{  TL_PAMArR  ,  VTJffiTOSS,  0,  OxFFFEF  ,  0x7FFFF,  OxFOOOO}, 

{  TLJSR?mH,  VIJWiESS,  0,  0x3FFFFF,  0  ,0  }, 

{  TL_FI£HAIK,  VTjyDEBESS,  0,  0x7FFFF  ,0  ,0  }, 

{  TL_PCPmK,  VTJWSESS,  0,  OxFFFF  ,0  ,0  }, 

{  TLJJIC  ,  VTjmyE  ,  0,  0  ,0  ,0  }, 

}; 

//  default  sectiens  in  the  Qnd.INI  file: 

oenst  static  diar  *def  []  =  {"Script",  ’Tyfeicro",  "Telemetry",  "Userlog",  ’Task",  "In",  "Out"} 
oenst  static  int  f®XDIRS  =  sizeof  (def ) /sizeof  {dnar  *); 

#define  IX_SCRIPr  0 

#define  IXJ©CPD  1 

#define  IXJTELEMETPy  2 

tdefine  IK  USERLOG  3 
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tdefine  IXJEASK  ‘  4 
Idefine  IX_IN  5 

#define  JXJUT  6 

//  edit  IDs  in  Prefeimoes-Dialog  (see  GND.PC) : 

ocaist  static  int  prefID[]  =  {  IDCJEDITl,  IDC_EDIT2,  IDC_EDIT3,  IDC_EDIT4, 

IDCEDIT5,  IX_EDIT6,  IX_EDIT7  }; 

///////////////////////////////////////////////////////////////////////////// 

//  OMfp: 

//  See  Qnd.cpp  for  the  iitplementaticn  of  this  class 

// 

class  CGhdSfp  :  public  CWin?^ 

{ 

public: 

CGn^Pgpi)^ 
f I  Overrides 

1 1  ClassWizard  generated  virtual  function  overrides 

//{ {AHXJ7IKraj^(OGnd?^) 

public: 

virtual  BOOL  InitInstanoe{) ; 

//}}jyEXj/iKra?yL 

//  Irtpleraentaticn 

//{{i^J©G(CQnd?^) 
afe jnsg  void  Cnftpp?toit()  ; 

//  NOTE  -  the  ClassWizard  will  add  and  ronove  mentoer  functions  here. 
//  X  NOT  EDIT  what  you  see  in  these  blodcs  of  generated  code  ! 
//}}AEXJCG 
i:HXAE^JdESSAGE_MAP  ( ) 

}; 


Gnd.cpp 

//  Ghd.qip  :  Defines  the  class  behaviors  for  the  application. 
// 

#include  "stdafx.h” 

#include  "Qid.h” 

#include  "neinfrm.h" 
tinclude  "Qiddoc.h" 

#include  "rrytabdlg.h" 
tinclude  "Gndview.h” 
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#ifdef  J£BJG 
#undef  THISJPILE 

static  char  BASEDJXDE  THLSJILEU  =  _FILE_; 

#endif 

///////////////////////////////////////////////////////////////////////////// 

//  CGnd?^ 

//{ {AEX_MSG_MAP  (OM^) 

Qnl^pgP^t) 

//  NOTE  -  the  ClassWizard  vdll  add  and  rHnove  roc^ping  rracros  here. 
//  DO  NOT  EDIT  Vvhat  you  see  in  these  blocks  of  generated  code ! 
//}  }AHX_MSG_MaP 

//  Standard  file  based  document  ccrtrrands 
CISMXMXIMSD  ( ID_ErLE_NEW,  CWin?^ : :  QnfileNew) 

CNjXiyMA^  OTin;^:  rOiFileC^) 

//  Standard  print  setup  ccnnand 

Cl^JXMJ®iND  (IDJETLEJEI^IISTJSEI^  CWin?^ : :  CnEiJLePrintSetup) 

ENDJ®  SSffiJ©P  ( ) 

///////////////////////////////////////////////////////////////////////////// 

//  CGhd?^  construction 

OGnd?^:  :0Gnd2^() 

{ 

in_pS27^pName=''P^SKr  Ground  Station"; 
mj)szProfileNarne="Qfxi .  INI"  ; 

} 

///////////////////////////////////////////////////////////////////////////// 

//  The  cne  and  only  object 

OQndftpp  theZ^; 

///////////////////////////////////////////////////////////////////////////// 

//  OGhdZ^  initialization 

BOOL  OQnd?^:  :InitInstanoe() 

{ 

//  Standard  initialization 

//  If  you  are  not  using  these  features  and  wish  to  reduce  the  size 
//  of  your  final  executable^  you  should  remove  from  the  following 
//  the  specific  initialization  routines  you  do  not  need. 


EhableSdCcntrols  ( ) ; 
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LcadStdProfUeSettingsC);  //  Load  standard  INI  file  cpticns  (including  MRU) 
WidgetsmitO ; 

//XTablelnitO; 

//  Register  the  applicaticn’s  document  tarplates.  Document  terrplates 
//  serve  as  the  connection  between  documents,  frame  windows  and  views. 

CSingleDocTenplate*  pDocTenplate; 
pDodTesiplate  =  new  CSingleDocTatplate  ( 

HUNTIiyEJlLASS  (OMDoc) , 

RUNTIMEJDLASS  (CJfeinErame} ,  //  irain  SDI  frame  window 

RUNriNE_CLASS  (OGndView) ) ; 

AddDocTertplate  {pDocTafrplate}  ; 

//  create  a  new  (eirpty)  document 
OiBileNewO; 

if  (m_lpQndLine[0]  !=  '\0') 

{ 

//  lODO:  add  oomond  line  processing  here 

} 

return  TRUE; 

} 

///////////////////////////////////////////////////////////////////////////// 

//  CRboutDlg  dialog  used  for  Pixsat 

class  CfiboutDlg  :  public  CDialog 
{ 

public: 

GtoitDlgO; 

//  Dialog  Data 

//{ {AEXJ}A!m(CRboutDlg) 
enum  {  IW  =  lUDJWJIKK  }; 

//}}MX_r]KrA 

//  iTTplementaticn 
protected: 

virtual  void  Dd::ataEx:change  {CDataExchange*  pDK) ;  //  DDK/IXV  support 

//{ {ABXjyEG  (C2taitDlg) 

//  No  message  handlers 
//}}AEX_MSG 

( ) 

}; 
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C24)OUtDlg:  :GAboutDlg{)  :  CDialog  (C3toDutDlg: :  IDD) 

{ 

//  { {ABXJDAmjHTr  (CRboutDlg) 
//}}AEX_DAia_INIT 


void  C2taitl)lg::Doi:)atBExchange(CDataExct^  pEK) 

{ 

CDialog: :  DoDataExchange  (pEK)  / 

//  { {AFXJZmTVjyiAP  (CAboutDlg) 

//}  }AEXJDAmjdAP 

} 

BEIMJESSAGEJ®P(CA^  CDialog) 

//{ {AEX_MSGjyiAP  (CtoutDlg) 

//  No  iiBSsage  handlers 
//}}AFXjyiSG_MAP 
ENDJ€SSAia:_MAP  { ) 

//  ocraiBnd  to  run  the  dialog 
void  OGndSpp:  rChZippRbout  ( ) 

{ 

(3iboutDlg  aboutnig; 
alxutDlg .  EtModal  ( )  ; 

} 

///////////////////////////////////////////////////////////////////////////// 
//  CGhd?^  ccurrends 


GndDoc.h 

//  Gnddoc.h  :  interface  of  the  CX3idDoc  class 
// 

///////////////////////////////////////////////////////////////////////////// 

class  OGndDoc  :  public  CDocument 

{ 

protected:  //  create  fron  serializatioi  only 
CXSndDocO; 

EmAREJ^M^^EAlE  (CChdDoc) 

//  Attributes 
public: 

3ybcro  *FMacro; 

c:PtrArray  c;  //  hcrtie  of  all  built-in  oarmBnds 


87 


CPtrArray  m;  //  hare  of  all  loaded  macros 
//  Cperaticns 
public: 


//  Overrides 

//  ClassWizard  generated  virtual  functicn  overrides 

//{ {ABXJTIRTCPVL  (OGndDoc) 

public: 

virtual  BOOL  CriSIevtonirent(} ; 

//}}AHXjnPTUAL 

//  Iiiplementaticn 
public: 

virtual  <X3:idDoc{); 

virtual  void  Seilalize  (CArcihive&  ar) ;  //  overridden  for  document  i/o 

#ifdef  JEBUG 

virtual  void  AssertValidO  const; 
virtual  void  IXnp  {CIXirrpCaitext&  dc)  ocnst; 

#endif 


protected: 

//  Generated  message  irep  functions 
protected: 

//{ {ABXjyiSG(CX3ndEtoc) 

//  NOTE  -  the  ClassWizard  will  add  and  ranove  mettber  functions  here. 
//  DO  NOT  EDIT  vhat  you  see  in  these  blocks  of  generated  code  ! 
//}  }AFX_MSG 
DEXIAREJ^ESSAffi_MAP  ( ) 


///////////////////////////////////////////////////////////////////////////// 


GndDoc.cpp 

//  Q:iddoc.cpp  :  iiiplementaticn  of  the  GQndDoc  class 

// 

#include  "stdafx.h" 

#include  "fcntl.h" 

#include  "sys/stat.h" 

#include  "Gnd.h" 

#include  "Ghddoc.h" 

#ifdef  DEBUG 
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#undef  THLSJTLE 

static  char  BASED_OOCE  1HIS_ETLE[]  = 

#endif 

///////////////////////////////////////////////////////////////////////////// 

1 1  CQidDoc 

CDocument) 

BEGIN JESSa3EJ^(0QndDc^  CDocurnent) 

//{ {i®yyiSG_mp  (OMDoc) 

//  NOTE  “  the  ClassWizard  will  add  and  remove  ir^ping  rtacros  here. 
//  DO  NOT  EDIT  \tot  you  see  in  these  blocks  of  generated  code! 
//}}AEX_MSGJ©P 
E1C)J€SSAGEJ®P() 

///////////////////////////////////////////////////////////////////////////// 

//  CXandDoc  ocnstructioi/destruction 


OCMDoc:  lOaidDocO 

{ 

//fifecro  =  new  9yfea:o(”D:\\ich\\hier\\kaiin\\daten.PCL”) ; 

} 


CXSndDoc:  :<GndDoc{) 

{ 

//  delete  fjyfecro; 

} 

BOOL  CGhdDoc:  :QnNevi)ocument() 

{ 

if  ( \ CDocument:  iQnNewDocument  ( ) ) 
return  FM£E; 

//  TOX):  add  reinitialization  code  here 
//  {SDI  documents  will  reuse  this  document) 

return  TBDE; 

} 

///////////////////////////////////////////////////////////////////////////// 

//  OSxiDoc  serializatioi 

void  CXMDoc: :  Serialize  {CArc±dve&  ar) 

{ 

if  (ar.IsStoringO ) 

{ 
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//  TCOO:  add  storing  code  here 

} 

else 

{ 

//  TCDO:  add  leading  exxie  here 

} 

} 

///////////////////////////////////////////////////////////////////////////// 

//  OQidDoc  diagnostics 

#ifdef  jraJG 

void  CXMDoc::AssertValid{)  censt 

{ 

CDocument : :  AssertValid  ( )  ; 

} 

void  OGkDoc:  :rXrip(CItjrrpC^  dc)  oenst 

{ 

CDocument:  :IXirtp(dc) ; 

} 

#endif  //_rEBOG 

////////////////////////////////// 

//  SQnd  irrplarentaticn 

// 

SQrd::SQTd() 

{ 

cmd  s=  0; 
wParam  =  0; 
iParam  =  0; 
ptr  =  {void  *)0; 

} 

SQTid::SQiti(int  nindex) 

{ 

cmd  =  nindex; 
wParam  -  0; 

IParam  =  0; 

ptr  =  (void  *)0; 

} 

SQnd:: -SQnd  0 

{ 

int  n; 

for  (rpO;  rKnArcmtCrnd,  DocQnd[n]  .cmdID!=cind;  n-f+); 
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switch  (DocQtd[n]  .wParamJType  &  OxFFOO) 

{ 

case  TQ_CMDPrR  :  if  ( (SQnd  *)ptr}  delete  (SQtti  *)ptr;  break; 

case  TQJT^SKPIR:  if  ({STask  *)ptr)  delete  (STask  *)ptr;  break; 

case  TOJOSPIR  :  if  ((SCSParams  *)ptr)  delete  (SOSParams  *)ptr;  break; 

} 

switch  (DoaQnnd[n]  .IParamJType) 

{ 

case  TL_CHFTR  :  if  ({SQnd  *)lParam)  delete  (SQnd  *)lParam;  break; 

} 

} 

BOOL  SQtd: ; Readstring  (void  *fh,  long  *pLong,  int  *pnErr) 

{ 

BOOL  err; 
char  c; 

CString  str  = 

for  (;  err  =  ReadFLle(fh,  &c,  1,  (LPDKOT))pnErr,  NULL),  *pnErr!=0,  cl='\0';  str  4-=  c); 
if  { !  (*pnErr)  1 1  err)  return  FKLSE;  //  unej^jected  eof 
else 
{ 

str  4^  '\0'; 

*plmg  =  (loig)  (new  char [ str. GetLengthO 4-1]  ); 
strcpy((char  *)  (*pLong),  LPCrsrR(str) )  ; 
return  TRUE; 

} 

BOCL  SQnd:  :Ioad(vDid  *fh)  //  load  oornends  as  they  v^re  saved  (see  SQrd:  :Save) :  only  ocrrmands 
{  //  without  password  and  referenced  files  (normally  from  disk) 

int  n,  WI^,  (fType,  ll^; 

iiit  th;  //  terrp  handle  for  add_task,  put_file  oocmends 

EWCRD  tlen;  //  teirp  file  length 

if  (ReadHile(fh,  &cmd,  1,  (LPDWCRD)  SnError,  NULL)  &&  nError==0)  return  TRUE;  //  eof 
for  (n=0;  n<nZtoritQrd,  DoaQtd[n]  .andID!=and;  n4-f-)  ; 

v/Type  =  DoaQid[n]  .vS^aran^Type  &  QxOOFF; 
c^^ype  ~  DooQrd[n3  .wParan^Type  &  OxFPOO; 

IType  =  DocQnd[n]  .IParamJiype; 

switch  (WType) 

{ 

case  TVOID  :  switch  (IType) 

{ 

case  TL  KKI?^R: 
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case  TL_ECBADR  : 
case  TL_ELSHAI:B: 
case  TLi_SRAiyMR: 

case  TLJJTC  :  if  ( IReadFlle  (fh,  slParanv  4,  (LPIKK))  snError,  NULL) )  return  EM5E; 
case  TL_CHPTR  :  if  (!FeadString(fh,  SlParam,  snError))  return  BMLSE; 
else  break;  //  go  on  with  (a) 

} 

switch  (q[I^)  //  (a): 

{ 

case  TQ_ayDPTR  :  ptr  =  new  SQrd; 

if  {!((  (SQtd  *)  (ptr)  )->Load(fh) ) )  return  EMSE;  else  break; 
case  TQJEASKPIR:  ptr  =  new  STask; 

if  {! Readstring (fh,  (long*)(&{  (STask  *)  (ptr)  ) ->taskname) ,  SnError) ) 
return  EMSE; 

if  (! Readstring (fh,  (lcng*)(&(  (STask  *)  (ptr)  ) ->disknane) ,  SnError)) 
return  HMSE; 

if  (!ReadEae(fh,  &(  (STask  *)  (ptr)  )->pri,  1,  (LPDWCRD) SnError,  NULL)) 
return  EKLSE; 

if  (th  =  CreateFile((  (STask  *)  (ptr)  ) ->disknarTe,  GENERIC_READ, 

mE_SimRE__FEAD, 

NULL,  OPENJMSTING,  FILEJL?C_SEaJEKI^  NULL) 

=  INVAUDJiMDLE_VRLUE)  return  ET^LSE; 

else 

{ 

if  (tlen  =  GetELleSi2e((void  *)th,  NULL)  ==  INVALID_FILE_SIZE  |  [ 
tlen  >  OxFFEF) 

{ 

CloseHandle  { (void  *)  th) ; 
return  EM5E; 

} 

else 

{ 

(  (STask  *)  (ptr)  )->size  =  tlen; 

(  (STask  *)  (ptr)  )-XJata  =  new  char  [tlen]; 

if  (!ReadEile(  (void  *)th,  &(  (STask  *)  (ptr)  )-xiata,  tl^, 

(LPDWCRD)  SnError,  NULL) )  return  HKLSE; 

CloseHandle  ( (void  *)  th)  ; 

} 

} 

break;  //  go  cn  with  (b) 
case  TQJDSETR  :  break;  //  tbd 

} 

break;  //  (b) :  go  cn  with  (z) 

case  IW^ao  :  if  (lReadEile(fh,  swRaram,  1,  (LPnraD) &nError,  NULL))  return  OTiSE; 
switch  (iType) 

{ 
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case  TW  DMA  : 


case  TW  MXKT: 


FALSE; 


case  TL_UIC  :  if  ( !PeadEile{fh,  SlParartv  4,  (LHJCRD) SnError,  NULL))  return  FALSE; 
else  break;  //  go  on  vcLth  (c) 

} 

break;  //  (c) :  go  on  with  (z) 

switch  (IType) 

{ 

case  TL_PCeiADR: 
case  TL_PCBADR  : 
case  TL_FISHADR: 

case  TLJSRSMADR:  if  ( !PeadFlle(fh,  &lParam,  4,  (IPDWCRD) SnError,  NULL))  return  FALSE; 

if  (!KeadFile(fh,  SwRaram,  1,  (LPIOT^) SnError,  NULL))  return  FALSE; 
else  break;  //  go  on  with  (d) 

} 

break;  //  (d) :  go  on  with  (z) 

switch  (iT^pe) 

{ 

case  TL_BLSEMR: 
case  TL_SB?ayArK: 

case  TLJRfiNACR  :  if  (!ReadEile{fh,  &lParam,  4,  (LPtXCRD) SnError,  NULL))  return  FALSE; 

if  (!ReadEile(fh,  &wParam,  2,  (LPDWCBD) SnError,  NULL))  return  FALSE; 
else  break;  //  go  cn  with  (e) 

case  TLJUHPIR  :  if  //  load  file  to  msn  (i.e.  put_file) 

{ 

if  (!  Readstring  (fh,  slParam,  shElrror))  return  FAI5E; 
if  (th  =  CreateELle((char  *)lPararrv  OTERIC_READ,  FILE_SHARE_READ,  NULL, 
OPFN[EXISTING,  F1LE_FLAG_SEX3UEM1AL_SCAN,  NULL) 
INVALIDJ^NDLEJ/A^  return  FALSE; 

else 

{ 

if  (tlen  =  GetFileSize  ( (void  *)th,  NULL)  =  INVALID_JILE_SIZE  1 1 
tlen  >  OxFFFF) 

{ 

CloseHandle  ( (void  *)th); 
return  FALSE; 

} 

else 

{ 

wParam  =  (  intl6)tlen; 
ptr  =  new  char  [tlen]  ; 

if  (!ReadFile({void  *)th,  ptr,  tlen,  (LPnraD) SnError,  NULL))  return 
CloseHandle  ( {void  *)  th) ; 

} 

} 

} 
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break;  //  go  oq  with  (e) 


} 

break;  //  (e) :  go  cn  with  (z) 

case  TW_CIKL  : 
case  1W  J02E  : 
case  1W  TRRT.TT  : 
case  TW_IEVEL  : 

case  IWJCWER  :  if  (!ReadEile(fh,  &wParam,  I,  (LPDraD) snError,  NULL))  return  BM5E; 

} 

return  TRUE;  //  (z) : 

} 

BOOL  SQmd:  :WriteString{void  *fh,  char  *pchar,  int  *p:fec) 

{ 

char  *p; 

if  (ipchar)  return  BKLSE; 

for  (p=pchar;  WriteELle{fh,  p,  1,  (IiPD5TO))pnEn:,  NULL);  pH-) 
if  {*p=='\0’)  return  TRUE; 
return  ET^LSE; 

} 

BOCL  SQid: :  Save  {void  *fh)  //  put  out  ooimands  without  password  and  without  referenced  files  (normally  to  disk) 

{ 

int  n,  WType,  cfType,  IType; 

if  (!WriteELle(fh,  Sard,  I,  (LPEWCBD) SnError,  NULL))  return  EmjSE; 
for  {n=0;  n<nSmounta:td,  DocCmd[n]  .aidID!=<ird;  n++) ; 

WType  =  DocQrd[n]  .wParamjrype  &  OxOOEF; 
grype  -  DocQnd[n]  .wParamJType  &  QxEEOO; 

IType  =  DocQTd[n]  .IParamJType; 

switch  (WType) 

{ 

case  TVOID  :  switch  (IT^) 

{ 

case  TL_PCRTA]:R: 
case  TL_PCBAnR  : 
case  TL_EI5H?m: 
case  TL_SR2M^: 

case  TLJJTC  :  if  (!WriteFile(fh,  iOParam,  4,  (LPIIO©) SriError,  NULL))  return  E?^LSE; 
case  TL_CHPrR  :  if  (!WriteString(fh,  (char  *)&lParain,  SnError) )  return  ESLSE; 
else  break;  //  go  on  with  (a) 

} 

switdi  (grype)  //  (a) ; 

{ 
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case  IW  CMD 


case  1W  n?vm  : 


case  1W  MXJNT: 


case  TW_crRL 
case  iwjyixe 
case  IWJEAHLE 
case  1W  LEVEL 


case  IQJMPTR  :  if  (!((  (SQtd  *)  (ptr)  )->Save{fh) ) )  return  EMSE;  else  break; 
case  TQJTASKPIR:  if  CiWriteStriiig{fh,  (char*)(&(  (STask  *)  (ptr)  ) ->>tasknanB) ,  snError)) 
return  EMSE; 

if  (!WrLteString(fh,  (char  *)  (£,(  (STask  *)  (ptr)  )->dis)tnaite),  snError)) 
return  EMjSE; 

if  (!Writeme(fh,  S(  (STask  *)  (ptr)  )->pri,  1,  (LPDMCRD) snError,  NOLL)) 
return  FALSE; 
break;  //  go  on  vdth  (b) 
case  TQjDSPTR  ;  break;  //  tbd 

} 

break;  //  (b) :  go  on  with  (z) 

;  if  ( IWriteFile (fh,  &wParam,  1,  (LPDWCBD) SnError,  NULL))  return  ETOSE; 
switch  (iType) 

{ 

case  TLJJTC  :  if  ( !WriteEile(fh,  slParam,  4,  (LPDCCRD) &nError,  NULL))  return  HT^E; 
else  break;  //  go  can  with  (c) 

} 

break;  //  (c) :  go  can  with  (z) 

switch  (IType) 

{ 

case  TLJE<KE7im: 
case  ILJCKyDR  : 
case  TLJELSHATR: 

case  TL_SRAMA]:R:  if  (!WriteEile(fh,  slParam,  4,  (IRDWOT) ShError,  NULL))  return  FALSE; 

if  (!WriteBile(fh,  &wPararrv  1,  (LPDWCED) SnError,  NULL))  return  FALSE; 

else  break;  //  go  cn  with  (d) 

} 

break;  //  (d) ;  go  on  with  (z) 

switch  (IType) 

{ 

c:ase  ILJLSHAHl: 
case  TL_SRAMAnR: 

case  TL_RAMAm  :  if  ( !Writ€File(fh,  &lParairv  4,  (LPD&OO) SnError,  NULL))  return  EAI5E; 

if  (!WriteElle(fh,  &wParam,  2,  (LPI50^) &nError,  NULL))  return  EM5E; 

else  break;  //  go  can  with  (e) 
case  TL_CHPIR  :  if  (c^Type^^rQJOTESS) 

if  (!WriteString(fh,  (char  *)&lParam,  snError))  return  FALSE; 
break;  //  go  cn  with  (e) 

} 

break;  //  (e) :  go  cn  with  (z) 
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case  TW_POWER  :  if  ( IWriteElle (fh,  &wParanv  1,  (IPIOTC) &nError,  NULL))  return  FALSE; 

} 

return  TRUE;  //  (z) : 

} 

BOOL  SQnd:: Execute  (void  *fh)  //  put  out  conrtBnds,  their  password  and  referenced  files  (nonrelly  to  OCMl) 
{ 

int  n,  WType,  c^Type,  IType; 

int  th;  //  tarp  handle  for  addj:ask,  putjfile  coiriBnds 
EWCHD  tlen;  //  taip  file  length 
long  iPassWord; 

if  ( IWriteBile  (fh,  sard,  1,  (LPDWCEO)  snError,  NULL) )  return  EPLSE; 
for  (n=0;  n<nArTDuntCtrd,  DocQtd[n]  .cmdID!=cmd;  n-n-)  ; 
if  (DocQTri[n]  .flags  &  F2ASS) 

{ 

IPassWord  =  GeneratePasswordO ; 

if  ( !WriteHile{fh,  SlPassWord,  4,  (IPDWCRD) SnError,  NULL))  return  ET^LSE; 

} 

Wiype  =  DocCind[n]  .wParamJType  &  OxOOFF; 
cfPype  =  DocQtid[n]  .wParamJType  &  OxFPOO; 

IType  =  DocCrad[n]  .IParamJI^; 

switch  (WType) 

{ 

case  TVDID  :  switch  (IType) 


file_shm:_read. 


case  TL_PaBTADR: 
case  TL_PCBAI3l  : 
case  TLJELSHAnR: 
case  TL_SRAMAER: 

case  TLJJIC  :  if  (!WriteEile(fh,  SlParam,  4,  (IPDWURD) SnError,  NULL))  return  FALSE; 
case  TL_CHPrR  :  if  ( !WriteString(fh,  (char  *)&lPararrv  SnError))  return  FT^LSE; 
else  break;  //  go  on  with  (a) 

} 

switch  (q(rype)  //  (a)  : 

{ 

case  TQ_CMDPTR  :  if  (!  ((  (SQnnd  *)  (ptr)  )->Execute(fh) ) )  return  FM£E;  else  break; 

case  TQJIASKPTR:  if  (!WriteString(fh,  (  (STask  *)  (ptr)  )->taskn3QTe,  snError))  return  E7\r5E; 

if  (!WriteFile(fh,  &(  (STask  *)  (ptr)  )->pri,  1,  (LPDWOT) SnError,  NULL)) 
return  EMSE; 

if  (th  =  CreateFlle{  (  (STask  *)  (ptr)  ) ->disknarre,  GE3SERIC_RE3^, 

NULL,  OPEN_EKISnNG,  FTIEjmG_SEX3UEl^^  NULL) 

=  INVALID  HANDLE  VALUE)  return  FALSE; 
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(LPEWCRD)  SnError, 


case  IW  OO 


case  IW  : 


case  IW  TyOTNT: 


else 

{ 

if  (tlen  =  GetFlleSize  ( (void  *)th,  NOLL)  =  INVArJD_Fri:E_SI2E  |  [ 
tlen  >  OxFFEF) 

{ 

CloseHardle  ( (void  *)  th)  ; 
return  FKL5E; 

} 

else 

{ 

(  (STask  *)  (ptr)  )->size  =  tlen; 

(  (STask  *)  (ptr)  )->data  =  new  char  [tlen]  ; 
if  (!FeadBile{(void  *)th,  &{  (STask  *)  (ptr)  )->data,  tlen, 

NULL) )  return  E?\LSE; 

CloseHardle  ( (void  *)  th)  ; 

} 

} 

if  {!WriteEile(fh,  &(  (STask  *)  (ptr)  )->size,  2,  (LPErao) SnError,  NULL)) 
return  EMSE; 

if  {!WriteELLe(fh,  &(  (STask  *)  (ptr)  )“>data,  tlen,  (LPDWCKD) &nError,  NULL)) 
return  E7\I5E; 
break;  //  go  cn  with  (b) 
case  TQjUSFTR  :  break;  //  tbd 

} 

break;  //  (b) ;  go  cn  with  (z) 

;  if  (!WriteEile(fh,  &wParam,  1,  (LPDWCRD) SnError,  NULL))  return 
switch  (iTVpe) 

{ 

case  TLJJTC  :  if  (!WriteBlle(fh,  slParam,  4,  (LEDtOT)) &nError,  NULL))  return  FALSE; 
else  break;  //  go  on  with  (c) 

} 

break;  //  (c) :  go  cn  with  (z) 

switch  (IType) 

{ 

case  TLJPCREArK: 
case  TL_PCE®m  : 
case  TL_ELSHaDR: 

case  TL_SRMyiADR:  if  ( IWriteEile (fh,  &lParam,  4,  (LEOCRD) &nError,  NULL))  return  FALSE; 

if  ( IWriteFlle  (fh,  Maram,  1,  (LPDWCKD)  &nError,  NULL) )  return  FALSE; 
else  break;  //  go  on  vdth  (d) 

} 

break;  //  (d) :  go  on  with  (z) 
switch  (IType) 


97 


{ 


case  TLJELSHAm: 
case  TL_SRSMAm: 

case  TL_B?mDR  :  if  ( !WriteEile{fh,  SlParam,  4,  (LPDCRD) snError,  NULL))  return  EALSE; 

if  ( IWriteEile  (fh,  &wParam,  2,  (LPEXCRD)  snError,  NULL) )  return  EM5E; 
else  break;  //  go  on  vd.th  (e) 

case  TLJlHPrR  :  if  (c$Pype=^rQj:o:s^S)  //  load  file  to  man  (i.e.  put_file) 

{ 

if  (! Writestring  (fh,  (char  *)&lParanv  SnError) )  return 
if  (th  =  CreateFile  ( (char  *)lParam,  GENEEICJREAD,  EXLE_SHAPE_EraD,  NULL, 
OPENJXISTING,  ETIE_EIi^_SEaJEM'IM^^  NULL) 

=  mmLJDjmDmjmm)  return  ET^LSE; 

else 

{ 

if  (tlen  =  GetEileSize((void  *)th,  NULL)  =  IN\ffiLID_EILE_SIZE  |  1 
tlen  >  QxEFEF) 

{ 

CloseHandle  ( (void  * )  th) ; 
return  E?UjSE; 

} 

else 

{ 

wParam  =  (  intl6)  tlen; 
ptr  =  new  char  [tlen]  ; 

if  (!ReadEile((void  *)th,  ptr,  tlen,  (LPDaCPD) SnError,  NULL)) 
return  E7\I5E; 

CloseHandle  ( (void  *)  th)  ; 


} 

} 

if  ( IWriteEile (fh,  &(  (STask  *)  (ptr)  )~>size,  2,  (LPDAOCi) snError,  NULL)) 
return  EfiLSE; 

if  ( IWriteEile (fh,  &{  (STask  *)  (ptr)  )~>data,  Uen,  (LPDIO^) SnError,  NULL)) 
return  EMISE; 
break;  //  go  cn  with  (e) 

} 

break;  //  (e) :  go  cn  with  (z) 
case  TWJUTPL  : 
case  IWjyiXE  : 
case  IWJEABLE  : 
case  'IWJjEVEL  : 

case  'IW_P0WER  :  if  ( IWriteEile  (fh,  Sv^aram,  1,  (LPEXOCi)  SnError,  NULL))  return  EMjSE; 

} 

return  TRUE;  //  (z) : 

} 

long  SQnd:  iGeneratePasswordO 


98 


{ 


return  OxABCD; 

} 

///////////////////////////////////////////////////////////////////////////// 

//  SMacro  irrplementaticn 

Siyfecro:  iSMacroO 

{ 

nError  =  WEPR; 
rn_bHasHll^aitie  =  ETOISE; 
m_hHasChanged  =  E?^E; 
rnjDlsBuiltln  =  TPOE; 
mjDlsScript  =  TRUE; 
m^arre  = 

MacrcName  = 

} 

ajfecro:  :Sfecro(int  nindex) 

{ 

nError  =  KCERR; 
mjDH^FileName  -  EMjSE; 
injDEfesCJianged  =  EKLSE; 
mjDlsBuiltln  =  TPOE; 
rrUDlsScript  =  TPUE; 

Eil^arre  = 


ly^cxcName  =  DocQrd  [nindex]  .cxintEind/ 

atid.A±i(new  SQid  (nindex) ) ;  //  call  ccnstructor  of  SQtid 

} 

ay&cro:  :3)^cro(<xnst  char 

{ 

int  ixl,  ixr,  d; 


nError  =  NCERR; 
mjDHasEileNarine  =  TRUE; 
mjDHasChanged  =  E2\LSE; 
m_bIsBuiltIn  =  ERLSE; 

FLLeNarte  ==  pName; 

ixr  =  FileNarre.ReverseElnd( ' . ' ) ; 

ixl  =  EileNarne.PeverseElnd( ' : ' )  +1; 

if  ( {d=EiJL^ame.ReverseEind(’\\')+l)  >  ixl)  ixl  =  d; 

if  (ixr=^l)  MacrcName  =  EilelSFarre.MLd(ixl)  ; 

else  MacrcName  =  EileName.Mid(ixl,  ixr-ixl); 

nError  =  LoadO ; 
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} 


SMacro:  ;~SM^cro() 

{ 

int  i,  irrax; 
sand  *pQtd; 

for  (i=0,  iinax==ard.GetUpperBound{);  i<=iirBx;  i++) 

{  • 

pQrd  =  {SQrd  *)aid.GetAt(i)  ; 
delete  pQid; 

} 

} 

int  SM&cro:  :Load() 

{ 

int  fh; 

DWCBD  flen; 

SQrd  *pand; 

if  (LPCTSTRCEileNto)  ==="”) 
return  EE^NOJETi^TOE; 

if  (fh  ==  CreateFile(LECISTR(m^arr^^  WEKLC_BEPD,  raE_SHKRE_READ,  NOLL, 
OPENJXESTING,  ETIE_EL^C_SEOTM1AL_^^  NULL) 

{ 

switch  (GetLastError  ( ) ) 

{ 

case  EE^EOl_FILEJCrr_KI^  :  return  EER_BILEJCT_KIJND; 
default  :  return  ERRJDPEN_p:r_REM)ING; 

} 

} 

if  (flen  =  GetElleSize  ( (void  *)fh,  NULL)  =  INV?ttiID_m£_SI2E) 

{ 

CloseHandle  ( (void  *)  fh)  ; 
return  FT^jAJFnr  Fj"RmTNTM;_Fn 

} 

do 

{ 

ard.Md(pQrd  =  new  SQrdO  )  ; 
if  ( !pard->LDad ( (void  *)  fh) ) 

{ 

CloseHandle  ( (void  * )  fh)  ; 
return  ERR  ICftDING; 
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} 


} 

.  vvhlle  (pannd->nError  !=  0);  //  Load  ok,  so  nError  coitains  arnount  of  bytes  read 

CloseHandle ( (void  *) fh) ; 

IsScriptO; 
return  NCEKR; 

} 

BOOL  Sl^cro : :  IsScript  ( ) 

{ 

int  i,  imax,  n; 

for  (i=0,  irrej?=<ird.GetU^rBound();  i<=imax;  i-H-) 

{ 

for  (n=0;  n<nJto3untC[Tid,  DocQiri[n]  .circ3ID!“((SQrnd  *)  (aixi[i]))->^^  n-H-); 
if  (!  (niJoIsScript  =  Docannd[n]  .flags  &  FPCL) )  break; 

} 

return  n^blsScript; 

} 

int  Siyfecro:  :Save() 

{ 

int  fh; 

int  i,  iiTBx; 

if  { ImjDHasEileName) 
return  EE^NO_Hll£l®iyE; 

if  (fh  =  Createme{IJECISm{m^arte),  G3^EKLC_WJnEr  0,  NULL, 

CREATEJJEW,  ElI£_FLAGJiIFaTEJ^  NULL) 

{ 

switch  (GetLastError  ( ) ) 

{ 

case  ERBCR_FILE_EXISTS  :  return  ERR_FriE_EXISTS; 
default  :  return  ERRJDPEN_FCSU«EOTIN^ 


for  (i=0,  irrBx==otd.Getl^perBound() ;  i<==imax;  i-H-) 
if  (!  (  ((SQrd  *)  (cnd.GetAt(i)))->Save{(void  *)fh))  ) 
{ 

CloseHandle  ( (void  * )  fh) ; 
return  ERR_SAVING; 

} 
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CloseHandle  ( (void  * )  fh)  ; 
return  KSBR; 

} 

int  ayfeciro: :  Overwrite  0 

{ 

int  fh; 
int  i,  max; 

if  ( !m_bHasEileNanE) 
return  ERR_^D_FIIiE^©ME; 

if  (fh  =  CreateEiJe(IOTSrR(BileNartie),  GMKECJSRTIE,  0,  NULL, 

Eri£_ELAGJ(IEU:ffi^^  NULL) 

^  INWODJimDIEjmiE) 
return  mjDPENjmjMTI]^; 

for  (i=0,  innax==crrd.Geti:5perBoun^  i<=dnBx;  i++) 
if  (!  (  ((SQtd  *)  (ard.GetAt(x)))->Save({void  *)fh})  ) 

{ 

CloseHandle  ( (void  *)  fh)  ; 
return  EE^j:)VERMTING; 

} 

CloseHandle  ( (void  *)  fh)  / 
return  NCEKR; 

} 

int  S^fecro:  :Execate  () 

{ 

int  fh; 
int  i,  iiiBx; 

if  ( !iiU:5iasHlieName) 
return  ERR  NO  FILENAME; 


if  {fh  ^  Createm.e(”OCm”,  CTmcCJflRITE,  0,  NULL, 

ORENJXESTINS,  ETLE_FIAGJi/Rmj^^  NOLL) 
=  INVALIDJffiNDr^^ 
return  ERR  OPEN  KR  EXFXXrriNo; 


for  (i=0,  irtej^=airi.Getl5perBound() ;  i<=dirBx;  i++) 
if  (!  (  {(SQtd  *)  (aid.GetAt(i)))“>Ex:ecute((void  *)fh))  ) 
{ 

CloseHandle  ( (void  *)  fh) ; 
return  ERR_EXE}CUTINO; 

} 
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CloseHandle  ( (void  *)  fh)  ; 
return  N3ERR; 

} 

int  Sbfecro:  :GetError() 

{ 

return  nError; 

} 

ocxLSt  char  *^fecro:  ;GetPildSfame() 

{ 

if  (irUiSfesEileName) 
return  IiPCTSTR(EileIS!aire); 
else  return  NULL; 

} 

BOOL  S^cro:  rSetFilelSIte  (const  char  ^ame) 

{ 

int  fh; 

if  (fh  =  CreateFlle (pName,  (3M]Rrc_WRriE,  0,  MILL, 

CPEATEJEW,  FTLEjmKIBUTEJCJEM^  NULL) 

{ 

if  (GetLastErrorO  =  EEOTIJFIIEJXISTS) 

{ 

Fil^ane  =  pName;  //  file  exists  '>  name  ok 
return  TRUE; 

} 

else 

{ 

nError  =  ERE^INVMiCD_FT^^ 

return  ET^E;  //  invalid  handle  IM5  file  doesn't  exist  ->  invalid  name 

} 

} 

else  //  valid  handle  file  did  not  exist  &  v©s  created  ->  name  ok 

{ 

CloseHandle ( (void  *)fh);  //  close  file  before  deletion!! 
if  (!DeleteEile(pName)) 

{ 

nError  =  EE^JPEMPJDELETCTCN;  //  THIS  should  never  h^pen! 
return  EMISE;  //  valid  handle  MD  file  couldn't  be  deleted  ->  ??? 

} 

EileiName  =  pName; 
return  TRUE; 

} 
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} 


const  char  *Syfecro:  :Get3yfecrdSIame() 

{ 

return  LPCTSTR(l^crc3Slarne)  ; 

} 

void  ayfecro:  :Se1d^crc^Iarne{cx3nst  char  *pName) 

{ 

//  TCtKFK:  check  for  validity  of  pWame  as  a  nBcroname 
MacrcNarae  =  pNarte; 

} 

////////////////////////////////////// 

//  STask  constructor/destructor 

// 

STask:  iSTaskO 

{ 

disknanie==tasknartE=(char  *)0; 

pri=0/ 

sizepO; 

data=i«L; 

} 

STask: : --STask  0 

{ 

if  (diskname)  delete  diskname; 
if  (taskname)  delete  taskname; 
if  (data)  delete  data; 

} 

/////////////////////////////////////// 

//  SOSParams  ccristructor/destructor 

// 

SOSPararrs : :  SOSParams  ( ) 

{ 

//  thd 

} 

SOSParams : :  ^SOSParams  ( ) 

{ 

//  tbd 

} 

///////////////////////////////////////////////////////////////////////////// 

//  OMDoc  oarmands 
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GndView.h 

//  Qndview.h  :  interface  of  the  OGndView  class 

// 

///////////////////////////////////////////////////////////////////////////// 


class  oandView  :  public  CView 

{ 

protected:  //  create  frcm  serialization  only 
OOndViewO; 

IKlAPEJDYJCREmE  (CGndView) 


//  Attributes 
public: 

CXSndDoc*  GetDocumentO  ; 


//  Cperations 
public: 

OfeinTabDlg  ^_pfPabDlg;  //  rrein  dialog  holding  all  childs  (from  CTabDlg) 


OCHScriptsDlg  inQiDlgO; 
OCHTelaiEtr^lg  nKhDlgl; 
CXHyfeilDlg  m_ChDlg2; 

OCHyfenDri©lg  ni_ChDlg3; 
CX3ControlDlg  inj3hDlg4  ; 
CXHOSCcntrolDlg  m_ChDlg5; 
OCHElleSystettOlg  rn_ChDlg6; 
CCHTaskCantrolDlg  rn_ChDlg7/ 


//  Child  tab  dialogs  (from  CTabDlgChild) 

//  telemetry  data  di^lay 
//  non-user  itailing  surveil  1  ance/iraintenance 
//  manory  peek/poke 
//  low-level  SOOS  and  PANSAT  functions 
//  hi^-level  functions:  T/T  and..  Event  Log,  User  Control 
//  file  systan  maintenance 
//  task  ccntrol  &  iTBintenanoe 


struct  PANSATELlelnfo  PFI  [MfiXDIRS]  ; 


//  Overrides 

//  ClassWizard  generated  virtual  function  overrides 

//{ {AFXJTIKrUAL  (OGndView) 

public: 

virtual  void  QnDraw(CDC*  pDC) ;  //  overridden  to  draw  this  view 

virtual  void  CninitialUpdate  { ) ; 

protected: 

virtual  BOOL  ChPreparePrdnting(CirintInfo*  pinfo); 
virtual  void  QiBeginPrinting (CDC*  pDC,  CPrintInfo*  pinfo); 
virtual  void  CnEhdPrinting  (CDC*  pIC,  CPrintInfo*  pinfo) ; 
//}}AFX_VIKrUAL 

//  Inplanentaticn 
public: 

virtual  -GGndViewO ; 
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#ifdef  JEBU3 

vi2±ual  void  AssertValidO  const; 
virtual  void  Durrp  (CI)unpCtntext&  dc)  ocnst; 

#endif 

protected: 

//  Generated  itessage  ir^  functions 
BOX  mJdTabDlgtJp; 

CString  strSectionDir; 

CString  strSecticnExt; 

CString  strSecticnDscrpt; 

CString  strSectio^Xfecro; 

protected: 

//{ {AEX_MSG  (CGndView) 
afxjnsg  void  OiUserAccess  ()  ; 
afKjnsg  void  CTiEndUserftcoess  ( ) ; 
afxjnsg  void  OiPreferenoes  ()  ; 

//}}AEXJSG 
imAKE JESSSGE JIAP  ( ) 

}; 

#ifndef  JEBUG  //  debug  version  in  Gndview.cpp 
inline  OQndDoc*  CGhdView:  :GetDocuriEnt() 

{  return  (CX3ridI>x:*)nj3Dc)a^^  } 
tendif 

///////////////////////////////////////////////////////////////////////////// 

GndView.cpp 

//  Qndview.qpp  :  inplanentaticn  of  the  OOndView  class 

// 

tindude  "stdafx.h” 
tind-ude  "Gnd.h" 

#indude  "Gnddoc.h” 

#indude  "n^rtabdlg.h" 

#indude  "password. h" 

#indude  "prefdlg.h" 

#indude  "Gndview.h" 

tifdef  JESJG 
#undef  THISJUE 

static  diar  BASEDJXIE  THISJUE  []  =  _FIIE_; 
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#endif 


///////////////////////////////////////////////////////////////////////////// 

//  OGndView 

CView) 

BEGINjyESSAaEJ^(OGi:^^  CView) 

//{ {AEK_MSG_M?\P  (OQndView) 

CNJXMyiOT(IDJOT^  QaUsertoess) 

CNjXMyM)^  CTEndUserAcoess) 

CWJjayMAND{ID_^^  CWPreferences) 

//}}AEX__MSG_MAP 

//  Standard  printing  oonmands 

CKJXIylylR^^  ( IDJFIIEJERINr,  CView : :  CnELlePrint ) 

CK_OCM®ND  { lEM;  XLiE_J’IUNr_PREVIEW  CView: :  CnFilePrintPreview) 
ENDJESSAGEJdAPO 

///////////////////////////////////////////////////////////////////////////// 

//  OGndView  ocristrix±icn/destructiC!n 

OQxJView:  :OGndView() 

{ 

int  i; 

strSectionDir  =  "Directories"; 
strSectionExt  =  "Extensions"; 
strSecticnDscrpt  =  "Descripticns"; 

OQxJApp  *p?^  =  (OCM^  *)AfxGet?^(); 

for  (i=0;  i<^EXDIBS;  i-f-f) 

{ 

PET  [i]  .Dir  =  p?^p->GetProfileString(stiSecticr^^  def  [i] )  ; 

PET[i]  .Ext  =  pApp->GetPromeString{strSecticnEx^  def  [i] )  ; 

PFT[i]  .Des  =  pApp->GetProfileString(strSectiaiDsapt,  def[i]); 

} 

m_brabDlgUp=E7iLSE; 

} 

OGndView:  :~OGndView() 

{ 

int  i,  iiriax; 

CGndDcx:  *pDoc  -  (OCMDoc  *)GetDocument()  ; 

//  destroy  tabbed  dialog 
if  (itjJdTabDlgOp) 
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inj]TabDlg->DestroyWiiid^  ( )  ; 
delete  mj/TabDlg; 
inJdrabDlgl^  =  EMSE; 


//  destroy  all  loaded  macros  stored  in  pDoc->in.  -Sfecro  takes  care  of  all  necessary  stuff, 
for  (i=0,  iitB>c^Doc~>m.GetUFperBoimd();  i<=iirBx;  i++) 
delete  (Syfecro  *)pDoc->m,GetAt(i) ; 

//  destroy  all  built-in  ooramands  stored  in  pDoc->c. 
for  (i=0,  iiiB>c^Doc->c.Geti:^perBa2nd{);  i<=inrax;  i++) 
delete  (afecro  *)pDoc->c.GetAt{i); 

} 


///////////////////////////////////////////////////////////////////////////// 

//  OCMView  drawing 

void  OOKiView:  :QiDraw{CDC*  pDC) 

{ 

OMDoc*  pDco  =  GetDocumentO  ; 

ASSEKr_VmD{pDoc)  ; 

//  TdO:  add  draw  code  for  native  data  here 

} 

///////////////////////////////////////////////////////////////////////////// 

//  OGndView  printing 

BOOL  OGhdView:  :QnPreparePrinting(Cl^intInfo*  pinfo) 

{ 

//  default  preparation 
return  DoPreparePrinting  (pinfo)  ; 

} 

void  OMView:  :CrffieginPrinting{CDC*  /*pDC*/,  CPrintInfo*  /*pInfo*/) 

{ 

//  TdX):  add  extra  initialization  before  printing 

} 

void  OGhdView:  :CnEndPrinting(OT  /*pDC*/,  CPrintInfo*  /*pInfo*/) 

{ 

//  TODD:  add  deanrp  after  printing 

} 

///////////////////////////////////////////////////////////////////////////// 

//  OMView  diagnostics 
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#ifdef  JEBUG 

void  OMView:  :AssertValid{)  const 
{ 

CView: :AssertValid() ; 

} 

void  CQxJView:  :IXiiTp(C!>irpO^  dc)  const 
{ 

CView:  :rxiip(dc) ; 

} 

OQidDoc*  CX3ndView:  iGetDocurrentO  //  ncn-ddxig  version  is  inline 

{ 

ASSERT  (mj5DDaitmt->IsKind^  (OTHIVEJZASS  (OGndDoc) ) )  ; 
return  (0GhdI^*)mj5Document; 

} 

#endif  //jmJG 

///////////////////////////////////////////////////////////////////////////// 

//  CXMView  message  handlers 

void  CXMView:  :QiUserAcoess() 

{ 

CPasswordDlg  dig; 
if  (dlg.]:mx3al()=IDCK) 

{ 

if  ( ImJiTabDlgl^) 

{ 

//  initialize  controls  in  child  dialogs 
//  IN^OataExchange  (TEOE) ; 

//  allocate  your  tab  dialog  object 
//  pass  in  parent  vdndcw 

in_pQ?abDlg  -  (CDfeinTabDlg*)  new  CltoiTabDlg (this); 

//  add  child  tabs  to  tab  dialog  internal  list 

m_jfl['abDlg~>AddChildDialog  (CXHScriptsDlg: :  Iin,  (CTabDlgChild  *)&mjShDlgO); 
in_pTabDlg~>AddChi  1  dPialog  (CXHTelemetryDlg: : IDD,  (CTabDlgChild  *)&rtKhDlgl); 
m_jfrabDlg->AddChildDialog  {CCmailDlg: :  IID,  (CTabDlgChild  *)  &m_ChDlg2)  ; 

injfrabDlg->AdcOnldDialog  (OCHyferDri^lg : :  HD,  (CTafcDlgChild  * )  &nKhDlg3)  ; 

mjyTabDlg->AdcniildDialog  (OCHCcntrolDlg : :  IDD,  (CTabDlgChild  * )  &rr^ChDlg4 ) ; 

rnjfrabDlg->AdidlhildDialog(CXBOSCantrolDlg:  :IIX),  (CTabDlgChild  *)  &rn_ChDlg5)  ; 
njjirabDlg->MiChi  1  dPialog  (CCHEileSystsriDlg: : IDD,  (CTabDlgChild  *)  &m_ChDlg6)  ; 
mjfrabDlg->Ad(XhildDialog  (OCHTaskCcntrolDlg : :  IIXi,  (CTabDlgChild  * )  &mJlhDlg7 )  ; 

m_ChDlg0.pPFI  =  &PFI; 
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//  fire  off  tab  dialog 

//  if  you  didn't  pass  the  parent  window  to  the  ocristructor 

//  you  should  pass  in  the  parent  vdndcw  as  the  second  paraireter  here 

]:njfrabDlg->DoMDdeless  {C3toiTabDlg : :  IDD,  this ) ; 

mJdrabDlgUp  =  TPUE; 

} 

} 

} 

void  OGndView:  :CnEhd!Jser?\caess  () 

{ 

if  {m_brabDlgl$5) 

{ 

nyirabDlg->DestroyWindow()  ; 
delete  nyirabDlg; 

Invalidate  0; 
nUdTabDlgUp  =  EMjSE; 

} 

} 

void  OGhdView:  :CnPreferenoes() 

{ 

int  i; 

CPreflDlg  dig;  //  constructor  call 
dlg.pQldPFI  =  &PFI;  //  initialize  dig  data 

CQnciPpp  *pSpp  =  (OMpp  *)AfxGetZ^(} ;  //  update  INI  settings  from  Qnd.INI 
for  (1=0;  i<X®XDIRS;  i++) 

{ 

PFI  [i]  .Dir  =  p?^p->GetProfileString(strSecticrto  def  [i] )  ; 

PEr[i]  .Ext  =  p?^p->GetProfileString(strSecticflnEi*  def  [i] )  ; 

} 

if  ({dlg.DcMDdalO  =  IDCK)  &&  (dlg.mJiHasChanged) ) 

{ 

for  (i=0;  i<MRXDIBS;  i++)  //  user  piressed  CK:  Directory  setting  validation 

{ 

pfipp->WriteProfileString  (strSecticnDir,  def  [i] ,  dlg.NewPEl  [i]  .Dir)  ; 

} 

} 


void  OQndView: :  Qnlnitiall^xjate  { ) 

{ 
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int  i; 

char  buf[5];  //  enou^  for  10,000  itacros 
CString  strMPatli; 
stiSectionf^cro  =  "IXfecro"; 

OGndE)oc  *pDoc  =  (CXSndDoc  *)GetDocument()  ; 

=  (CGnd?^  *)AfxGetSfp() ; 

//  load  all  iiBcros  referenced  in  *.mr  to  pDoo'>in.  The  a^cro  constructor  actually  leads  ’em. 
for  (i=0;  ;  i+t) 

{ 

strf€>ath  =  p?ifp->GetProfileString(strSectich^fecro,  itoa{i,  buf,  10),”;"); 
if  {!strarp(LPC:iSlR(st3i^a^^  break; 

pDoC“>m.Add(new  S^fecro(LPC^STR(stli^Path) ) )  ; 

} 

//  get  all  built-in  corrrnands  to  pDoc->c 
for  (i=0;  i<nSiTCfuntQrd;  i++) 
pDoc->c  .Add  (new  a^cro  (i) )  ; 

eview:  iQiInitialUpdate  () ; 

} 


MainFrm.h 

//  rrainfm.h  :  interface  of  the  O^inEcame  class 

// 

///////////////////////////////////////////////////////////////////////////// 


class  QfeihErame  ;  public  CErameWhd 

{ 

protected:  //  create  from  serialization  only 
OfeinErameO; 

(CMainFrams ) 

//  Attributes 
public: 

//  Operations 
public: 

//  Overrides 

//  ClassWizard  generated  virtual  function  overrides 
//{ {AEX_VIKraAL  (ClSfeinFrane) 

//}}AEXJOTTUAL 

//  Iicplanentaticn 
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public: 


virtual  ~C2y3ainFtame(); 

#ifdef  _DEBUG 

virtual  void  AssertValidO  const; 
virtual  void  airtp(CDurTpCQntext&  dc)  caist; 

#endif 

protected:  //  control  bar  orbedded  inerrbers 
CStatusBar  mj^ndStatusBar; 

CToolBar  m^wndToolBar; 

//  Generated  message  functions 
protected: 

//{ {AEKJCG  (OfeinFrarre) 

afecjnsg  int  OiCreate  (LPCREATESTPOCT  IpCreateStruct)  ; 
//}  }ABX_MSG 
IH3J;j?EJ€SSAGEJ^  ( ) 

}; 


///////////////////////////////////////////////////////////////////////////// 


MainFrm.cpp 

//  uBinfm.cpp  :  iirplanentation  of  the  QfeinFrame  class 

// 

#inciude  "stdafx.h" 
tinclude  "Qnd.h” 

tinclude  "gnddoc.h" 

#iiiclude  "rrainfm.h" 
tinclude  <stdio.h> 

#ifdef  _EEBUG 
tundef  THISJFTIE 

static  char  BASEDJOTG  'IHIS_E1LE[]  =  _EELE_; 

#endif 

///////////////////////////////////////////////////////////////////////////// 

//  O^feinFraaiE 

CFrarti^M) 

BEGIN J^ESSaai jyiAP(a^tdiiFrame,  CErame’Whd) 

//{ {AEX_MSG_MAP  (OfeinErarre) 

CNJ«M_CRE?aE{) 
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//}}AEXJCGM?^ 

EM)J€SSftGE_MAP() 

///////////////////////////////////////////////////////////////////////////// 

//  arrays  of  IDs  used  to  initialize  control  bars 

//  toolbar  buttons  -  IDs  are  oornand  buttons 
static  UINT  BASEDJOTE  buttons  []  = 

{ 

//  same  order  as  in  the  bitm^  ' toolbar. hnp' 

ID_m£JW, 

ID_FIIE_OPEN, 

ID_EILE_SAVE, 

ID_SEERRArcR, 

IDJDITJUr, 

IDJDITJjOFY, 

IDJEDITPASTE, 

ID_SEPJ!iRATCR, 

ID_FIIE_ERINr, 

ID_APP_ABCUr, 

}; 


static  UINT  BASEDJjCTE  indicators  []  = 

{ 

ID_SEEARATCR,  //  status  line  indicator 

IDJM)ICMmC?iPS, 

IDJ2®IOTm_NaM, 

ID_™iCmK_SCRL, 

}; 

///////////////////////////////////////////////////////////////////////////// 

//  CDfeinFrame  construction/destruction 

OfeinErame:  :CMainFtaiie{) 

{ 

} 

dfeinFrame : :  MDytiinErarne  ( ) 

{ 

} 

int  ayfeinFiarre:  :aiCreate(LPCRE?ffi^  IpCreateStruct) 

{ 

if  (CFianeVtad:  :CriCreate  (IpCreateStruct)  =  -1) 
return  -1; 

if  (!m  wndToolBar. Create  (this)  |! 
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!Ir^wnc^^colBar.LoacBitrr^{IDI^^5^^  1 1 
!mj^oc£roolBar.Set3attons  (buttons, 
sizeof  (buttcns)  /sizeof  (UINr) ) ) 

{ 

TR?CE0{"E^ed  to  create  toolbar\n"); 
return  -1;  //  fail  to  create 

} 


if  {!mj«zndStatusBar. Create  (this)  1| 

Iinj^ndStatusBar.Setlnc^  (indicators, 
sizeof  (indicators)  /sizeof  (UIOT) ) ) 

{ 

TRSCE0(  "Exiled  to  create  status  bar\n”); 
return  -1;  //  fail  to  create 

} 

//  TCEO:  Delete  these  three  lines  if  you  don't  want  the  toolbar  to 
//  be  dockable 

rnj^indroolBar.EnableDockirig(CBF!SJ^  ; 
EnableDocking(CBE^jaZGNJ^  ; 

DockCcntrolBar  ; 

//  TCBD:  Remove  this  if  you  don't  want  tool  tips 
xri_wndroolBar .  SetBarStyle  (inj^ndToolBar .  GetBarStyle  ( )  | 

CBRSJXX3LTIPS  [  CBRS_ELyBY)  ; 

/* 

oyfenu  *ptfenu  =  Gettfenu()->GetSut^fenu(l); 

Fiyfenu->Ei:^ldyfenuIt0n(IDJ^OCE^^  MFJS^SYED  I  W_BYCCmM)) ; 

*/ 

return  0; 

} 

///////////////////////////////////////////////////////////////////////////// 
//  ayfeinFrame  diagnostics 

#ifdef  jmOG 

void  a^feinFYrarre:  :AssertValid()  const 

{ 

CRrameWhd:  :AssertValid() ; 

} 

void  CMainFrarre:  :Eunp(C[>JD:rpCb^^  dc)  const 
{ 

CErame&&]d:  rIXirp  (dc) ; 

} 

#endif  //JEBDS 
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///////////////////////////////////////////////////////////////////////////// 
//  C^feinErame  message  handlers 
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B.  DIALOG  SOURCECODE 


Every  groundstation  child  dialog  has  its  own  include  (*.h)  and  implementation 
(*.cpp)  file.  Except  the  Script  dialog  (ChScript)  all  other  dialogs  do  not  have  any  special 
code  besides  the  MS  VC  provided  framework  yet.  That  is  why  they  are  not  listed  here 
{ChTlmtry,  ChMail,  ChMemory,  ChOSCtrl,  ChCtrl,  ChFileSy,  ChTaskCt,  MainTab). 


ChScript.h 

ChScript.cpp 

MyTabDlg.h 


Include  file  for  Scripts  tabbed  dialog 
Implementation  file  for  Scripts  tabbed  dialog 
Include  file  for  all  child  dialog  include  (*.h)  files 


ChScript.h 

//  ChScript.h  :  header  file 

// 

///////////////////////////////////////////////////////////////////////////// 

//  CTHScriptsDlg  dialog 

class  OCHScriptsDlg  :  public  CTabDlgChild 

{ 

//  Cciistructiaa 
public: 

CX3IScriptsDlg((»d*  pParent  =  NULL) ;  //  standard  caistructor 

//  Dialog  Data 

//{ {AEXJ]RIA(OClIScriptsDlg) 
enum  {  IDD  =  IWJBSCPIFTS  }; 

//  NOTE:  the  ClassWizard  will  add  data  itienbers  here 
//}}AEX_DKIA 

struct  PANSRTEileInfo  (*pPEI)  [MAXDIR5]  ; 

CString  m_strFilter,  injstrGhdDir; 
wm  m_hlE)ditMDde;  //  hl=«otLinked 
WPD  irUilScriptType; 

Icng  mjCurCode; 

3XIacro  inj^ctualiyfecro; 

OPE3SIFriEt©ME  m  ofn; 


//  Overrides 
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//  ClassWizard  generated  virtual  functicn  overrides 

//{ {ABX_VIKraRL  (OCHScriptsDlg) 

protected: 

virtual  void  DoDataExchange  (CCataExchange*  pEK) ;  //  DEK/IXJV  support 

//}}AHX_VIRrQAL 

//  Irrplementation 
void  NewMacroO  ; 
protected: 


//  Generated  message  it^  functiais 
//{ {AEX_MSG(CX3!ScriptsDlg) 
virtual  BCX3L  aiInitDialog(}; 
afx_msg  void  CtiEraseBditline  ( )  ; 
afejnsg  void  CnCatToBditline() ; 
afxjrnsg  void  QnlnsertEdi.tl  i  ne  ( ) ; 
afxjnsg  void  CninsertO; 
afxmsg  void  OiEdit { ) ; 
afxjnsg  void  QnLcad  ( )  ; 
afxjnsg  void  QaSave  ( ) ; 
afxjnsg  void  CnSaveAs  ( ) ; 
afxjnsg  void  ChNewO ; 
afx jnsg  void  QnDeleteO  ; 
afxjnsg  void  CM£lickListQtd() ; 
//}}ABXJVISG 

MESSAffiJIAP  ( ) 


ChScriptxpp 

//  chscript.cpp  :  irrplanentation  file 

// 

#inciude  "stdafx.h" 

#include  "Gnd.h” 

#include  "chscript.h" 

#ifdef  JCEBUG 
#undef  THIS_FILE 

static  char  BASEDJXDE  THIS_JIIiE[]  =  _FILE_; 

#endif 

#defiiie  TYPE_SCRIPr  1 
#defiiie  TYPEjyrao  2 

///////////////////////////////////////////////////////////////////////////// 

//  CXHScriptsDlg  dialog 
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OCHScriptsDlg:  :OCHScriptsDlg((3t3d.*  pParent 

:  CTabDlgChildiCCElScriptsDlg:  :IED,  pParent) 

{ 

//{ {mijmAjmr  (OCHScriptsDlg) 

//  NOTE:  the  ClassWizard  will  add  nerber  initialization  here 

mJilEditMode  =  0; 
nytil^criptType  =  0/ 

} 


void  OCHScriptsDlg:  :DoDataEiichange(CDataEKchange*  pEK) 

{ 

CTabDlgChild:  :DoDataEx:change  (pEK)  ; 

//{ {AEXJSTOMAP  (OCHScriptsDlg) 

//  NOTE:  the  OlassWizard  will  add  ITK  and  DDV  r^l  l.g  here 

} 


BEXlCNJ€SSAGEjyiAP(OCHScri^^  CTabDlgChild) 

//  { {AEXjyiSG_MAP  (OCHScriptsDlg) 

CNJXt^M?M)(IIX:_SCI^  CnEraseBditline) 

CNJXIX^ffit®(IEC_SCRIP^^^  QnCatToEditline) 

CNJXM^ND  (irx:_SCRIPr_INSEKrEL,  OxEnsertEJditline) 
CNjXiyiyM)(lDC_SCKr^^^  Cninsert) 

CNJSCM®ND(IDC_SCKCP^^  ChEdit) 

CNjri)M®(IDC_SCR^  CnLoad) 

aSKXMyTO(ID:_SCKr^^  cnsave) 

CNjXM^®I®{irr^^  CnSaveAs) 

CNJXMJ®M)(IDC_SCI^  CbNew) 

CNJXlM^(IDC_SCiaPT^^  CnDelete) 

CNJXNIPCL(W^^^  IDC_SC3y[Pr_LISTCMD,  CWXlickListCM) 

//}}AEX_MSGjyM> 

EKD_MESSAGE  MAP() 


///////////////////////////////////////////////////////////////////////////// 

//  OCHScriptsDlg  message  handlers 

BOCL  OCHScriptsDlg  ::CriInitDialog{) 

{ 

CT^DlgChild:  :CnlnitDialog() ; 
int  i; 
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CHBRadio  ^jiJBditMDde  =  (CHBRadio  *)GetDlgItern(irx:_SCK[Prj053^^ 
CHBRadio  *pScriptType  =  (CHBPadio  *)GetDlgIte[n{Iir_SCKCPr_SCK[^^ 
CHList  *pQnndList  =  (CHList  *)GetJ3lgItem{Iir_SCRIPrjJSTOT 
CHList  *pScriptList  =  (CHList  *)GetDlgItem(in:_SCKEPr_LISTSCia 
CHBdit_SS  *pBditQrd  =  {CHBdit_SS  *)GetDlgItem(IDC_SCRIPrjDITC^ 
CHBdlit_SS  *pBditP  =  (CHBditjSS  *)GetDlgIt€m(Iir_SCRIPr_P)  ; 

pBditiybde->Set]::BtaI j„nk  (TRUE,  &mJiLEditiybde) ; 
pmLtMDde->SetState(TRUE,  ET^LSE); 
pScxiptType->SetDataT.jink  (THJE,  fflnJiLScriptType)  ; 
pScriptType~>SetState  (TBLE,  BM5E); 
for  {i=0;  i<5iAnojQtCttd;  ±++) 
pQnrlList~>Mi[t0ii(Do(^^  .ocnrnarid) ; 
pQidList->Sel€CtData(DocQTd[0]  .ootr^  HLJSEIKIT); 
pScriptList->AddItQii("  (next) ")  ; 
pScriptList->Selectr:ata  (”  (next) ",  HL_SE1ECI) ; 
pEditQrd->SetWindcwrext  ("")  ; 
pBditP->SetWirxMext  ("")  ; 


n^strQxIDir  -  "D;\\Gcound"; 
m_strEilter  =  "AH  Elies  (*.*)"; 
n^strEllter  4=  '\0'; 
mjstrEllter  ”*.*"/ 
iti_strEilter  '\0'; 

for  (i=0;  i<E®XDIRS;  i++) 

{ 

m_strEllter  -h=  (*pPFI)  [i]  .Des; 
rr^strFllter  +=  '\0'; 
in_strFilter  4=  (^pPET)  [i]  .Ext; 
mjstrEllter  4<=  '\0'; 

} 

mjstrEllter  +=  '  \0 ' ; 

iTjofn.lpstrEllter  =  LPCISTR(m_strEllter)  ; 
mjDfn.lStructSize  =  sizeof  (itjofn)  ; 
njofn.hwTKjOwner  =  rtiJIEW; 
itjofn.hinstanoe  =  NULL;// 
iijofn.lpstrCustatiEllter  =  NULL;// 
mjDfn.riMaxCustEllter  =  0;// 
iijpfn.nElleQffset  =  0;// 
njofc.nElleExtensioi  =  0;// 
m_ofri.lCustData  =  0;// 
mjDfn.lpfinHook  =  NULL;// 
mjDfn.lp/rorplateName  =  NULL;// 
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} 


return  TRUE;  ft  return  TRUE  unless  you  set  the  focus  to  a  control 
//  EXCEFTICN:  OCX  Prq^erty  Pages  should  return  BRLSE 


void  OCHScriptsDlg:  rOnEraseBditline  () 

{ 

Cm]it_SS  *pEjditQnd  ==  (aEdit_SS  *)GetDlgIt€m(IX_SCKEPr_EDITC^ 
CHBdit_SS  *5®ditP  =  (CHEdit_SS  *)GetDlgIt€ra{Iir_SCRIPr_P)  ; 


pEmtCM~>SetWijnda^Itext  ; 
pBditP->SetWindcWrext  ( "" )  ; 

} 

void  OCHScriptsDlg:  :CninsertEditline() 

{ 

CString  str; 
int  n,  ix; 

CHList  *pScriptList  =  (CHList  *)GetDlgItm(IDC_SCPIPT_IirSTSCRIPr)  ; 

CHBdit_SS  *pEditQnd  ==  (CHEdit_SS  *)GetDlgItem(IDC_S(:mPr_EDIT^ 

CHDdit_SS  *pBditP  =  (CHe±Lt_SS  *)GetDlgIt€m{irx:_SCRIPr_P)  ; 

CHBRadio  *pScriptType  =  (CHBRadio  *)GetDlgItem(IDC_SCRrPr_SCK[FT}  ; 

CHBRadio  ^*pMacroType  =  (CHESRadio  *)GetDlgItem(IDCjSCK[Prj^^^ 


pBdit(M“>GetWincbt/rext  (str) ; 

ix  =  pScriptList->InsertItem(pScriptList->GetCurSel  {) ,  (void  *)  LPCrSTR(str) )  ; 
pScriptList->SetCurSel  {pScriptList-*>GetCurSel  ( )  ~1)  ; 

for  (n=0;  n<liSmountQrrd,  strarp(DocChid[n]  .occtrrand,  str)  !=0;  n4+); 
m_Actualiyfecro .  and .  InsertAt  (ix,  new  SQid  (n) )  /  //CPtrArray :  InsertAt  ( ) 
m_Actuallfecro  .mjSIasChangecMPUE; 

if  (mJ^ctualI^cro.IsScript() )  pScriptIVpe->SetState (IPUE,  TRUE); 
else  pMacrcType->SetState  (TRUE,  TRUE)  ; 

} 

void  OCHScriptsDlg:  rCnCutToBditline  ( ) 

{ 

char  str  [40]; 
int  ix; 

GHTAst  *pScriptList  =  (CHList  *)GetDlgItem(irC_SCRIPrjJSTSCRIPr) ; 

CHEdit_SS  ^‘pBditOnd  =  (CHEait_SS  *)GetDlgIten(Iir_SCK[PrjI)r]OT 

CHBdit_SS  *pBditP  =  (CHE)dit_SS  *)GetDlgIt€m(IDC_SCKrPr_P)  ; 

CHBRadio  *pScriptType  =  (CHK^dio  *)CfetDlgItem(IDC_SCRIPT_SCRIPr)  ; 

CHBRadio  ^pMacroType  =  (CHBRadio  *)GetDlgIt€m{irx:_SCI^PTJ®CR^ 

pScriptList“->GetCurr:ata  (str,  39) ; 
if  (stratp(str,  "(next)")) 

{ 
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pScd.ptList->DeleteItan(ix  =  pScriptLd.st->GetCurSel  () )  ; 
pScriptList->SetCurSel  (pScriptList-XSetCurSel  ( )  +1) ; 
pBctLtQTd->SetWijKicwre}ct  (str) ; 

InJ^ctual^fecro.ard.Par^  //CPt:rft2:ray:  BemoveAtO 

rn^Artuaimcro  .mJiHasChangecMBDE; 

if  (rnJictnjaliyfecro.IsScri^^  pScriptType-*>SetState (TBIJE,  TRUE); 
else  piyiacrdrype->Se1:State  (TF!DE,  TRUE)  ; 

} 

} 

void  CICHScriptsDlg:  rCnInsert  () 

{ 

int  ox,  n; 
char  str  [40]; 

CHUst  *pQtdUst  =  (CHList  *)GetDlgItem(Iir_SCRIPrjZSTC^^ 

CHList  *pScriptList  =  (CHList  *)GetDlgItem(IIX_SCRIPrjLISTS(3^Pr)  ; 

CHEdit_SS  ^pEditOrd  =  (CHBdit_SS  *)GetDlgItQn(IirjSCRIPr_EDITCI® 

CHEdit_SS  *pBditP  =  (CHB±Lt_SS  *)GetDlgItem(IDC_SCRIPrjP) ; 

CHBRadio  ^pScriptiype  =  (CHBRadio  *)GetDlgItern(Ilx:jsa^Pr_S^ 

CHBRadio  ^pMacrdiype  =  (CHBRadio  *)GetDlgIt€m(IDC_SCRIPrjyiAC^ 


pQnndList->GetCur]Data(str,39) ; 
pBditQrd->SetWijxk^  (str) ; 

for  (n=0;  n<nZtaxintQrd,  strcnp(DocQTd[n]  .oDrarand,  str)  !=0;  n-H-); 
if  (DocQttl[n]  .wParamjrype==KrV0ID  &&  DooOmd[n]  .lPararnj:ype==<rVDro^ 
{ 

ix  =  pScriptList->InsertItan(pScriptList->GetCurSel(),  str); 
pScriptIjist“>SetCurSel  (pScriptT  n  st-XfetCurSel  ( )  -1) ; 


mActuall^cro . cmd> InsertAt (ix/  newSQrd(n));  //CPtrArray:  InsertAtO 
m_ActualMacro  .rnJciiasCtBngecNI^^ 

if  (rnJ^ctualBfecro.IsScript() )  pScriptType~>SetState (TRUE,  TRUE)  ; 
else  pJ^crcO?ype->SetState  (TRUE,  TRUE)  ; 

} 

} 

void  OCHScrLptsDlg:  :CnBdit() 

{ 

char  str  [40]; 

CHList  *pClidList  =  (CHList  *)GetDlgItem(IIX_SCRIPrjLrsraC>) 
CHSdit^SS  *pBditQtd  =  (CHEidit_SS  *)GetDlgItQm(Iir_SCRIPrjI)ITCl^ 
CHEdit^SS  *pBditP  ^  (CHBdit_SS  *)GetDlgItan(IDC_SCRIPr_P) ; 

pQTTdList->GetCurCata  (str,  39)  ; 
pBditand,->SetWindcWrext  (str)  ; 

} 
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void  CCHScriptsDlg:  lOiLoadO 
{ 

char  buf  [256]  ; 
char  fearre[256]; 
buf[0]  =  »\0’; 

m_ofia.nFilterIndex  =  mJilScrip1:lVpe==<^^  ?  IX_SCKtPr+2  :  rx_MACR>2; 

m_ofri,lpstrEile  =  buf; 

xr^ofn.nMaxEile  =  si2eof(baf); 

m_ofii.lpstrFileTitle  =  fnarae; 

in_ofn.n^fexFileTitle  =  sizeof  (fname) ; 

mjDfeapstrlnitialDir  =  LPCTSn[R(mJil^iptIVpe=^^  ? 

{*pPFI)  [IX_SCRIPr]  .Dir  : 

(*pPEl)  [IX_MACPO]  .Dir)  ; 

mjofn.lpstrTitle  =  "Load  Macro"; 

mjofn. Blags  =  OFN_FrLEMJSTEXrST  |  OBN_EAIHyOSTEXIST  [  OBNJUDEREJmJLY; 
mjofe.lpstrlfefExt  =  LPCISTR(mJilSCTipt:T^  ? 

(*pPFl)  [IX_SCRIPT]  .Ejct  : 

(*pPFl)  [IX_MRCRO]  .Ext) ; 


CbNewO; 

if  (GetC^)enBileNarrB(&n^ofn) ) 
if  (mJictualDfecro,Load()  !=  NCERR) 

MsssageBox ("Error  viiile  loading  iracro!",  "Load  Ifecro",  MB_CK) ; 

} 

void  OCHScriptsDlg:  rCbSave  () 

{ 

int  nSavePesult,  ioresult=NCERR; 

CString  strText,  stfHeader; 

BOOL  bIsScript; 

CHBRadio  *pScriptType  =  (CHBRadio  *)(fetDlgItan{IDC_SCRIPr_SCRIFT)  ; 

CHBRadio  *p^fecrd^ype  =  (CHBRadio  *)GetDlgItsn(IDC_SCRIPT_t®^^ 

if  (bIsScript  =  mJ^cfmlMacro.IsScript() )  pScriptType->SetState (TRUE,  TRUE); 
else  p^fecrc^^Ype->SetState  (TFUE,  TRUE)  ; 

if  (mJk±ual^fecro.^ty3HasFileName) 

{ 

if  (ioresult  =  mJ^ctualMfecro . Save  ( )  =ERI^E1LE_BXISTS) 

{ 

strText  =  Err2\ry [ioresult]  +  CString {"\nChoose  CK  to  overwrite  it."); 
strHeader  =  "Save  "  +  mJ^ctiHlMacro.ElleNarns; 

nSaveResult  =  MessageBox  (strText,  strHeader,  MBJLCCNINKROTICN  |  lyBjIECMEL) 
if  (nSaveResult“IDCK)  ioresult  =  mJ^ctualJ^cro. Overwrite  ()  ; 

} 
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} 

else  CnSaveAsO; 
if  (ioresult!=^^CERR) 

{ 

^fessageBcK(EnAry[ioresult]/"File  Error",  MB_CK); 
return; 

} 

mJ^ctualJyfecTo.injDH^Ch^  =  FKLSE; 

} 

void  CXUScriptsDlg:  rOnSaveAs  () 

{ 

char  buf[256]; 
char  fi:iame[256]; 
buf[0]  =  ’\0'; 

BOOL  blsScript; 

CHBRadio  *pScriptType  =  (CHBRadio  *)GetDlgItem(irr_SCK[PrjSOT 
CHBRadio  *piyfecrcfrYpe  =  (CHBRadio  *)GetDlgItem(IIX_SCK[Prj^A^ 

if  (blsScript  =  mJ^ctuaI^fecro.IsScript())  pScriptTYpe->SetState (TE^,  TRUE); 
else  pN^crcType->SetState  (TRUE,  TRUE)  ; 

mjDfn.nfllterlndex  =  blsScript  ?  IX_SC3^Pr+2  :  IXJ®CRCH-2; 

mjofn.lpstrEile  =  buf; 

rr^ofn.riJyfeKFile  =  sizeof(buf); 

ir^ofn.lpstrEUeTitle  =  &iame; 

n^ofn.ityiaxEileTitle  =  sizeof  (finame); 

mjDfii.lpstrlnitialDLr  .==  LPCTSTR (blsScript  ? 

(*pPFI)  [IX_SCRIPr]  .Dir  : 

(*pPEi:)  [IXjyiACRD]  .Dir)  ; 
m_ofn.lpstrTitle  =  "Save  I^cro  As. 
mjDfo.KLags  =  OE\fl_pjEm9rrEeBa^  \  OHNJffDEREADCNLY; 
m_ofn.lpstrDefEKt  =  LPCTSTR  (blsScript  ? 

(*pPEI)  [IX^SCRIPT]  .Ext  : 

(*pPIT)  [IX_MACRD]  .Ext)  ; 


if  (GetCpenEileName(&m_ofii) ) 
{ 


mJVctuaIJMacro.File^^^  =  n^ofn.lpstrEile; 
rnJ^ctualMac]r).iiyDEfesF^  =  TRUE; 

if  (mJ\ctualDfecro.Save()  =  NCERR)  mJ^ctual^fecro.mJ3HasChanged  -  FALSE; 

} 


} 


void  CX3IScriptsDlg:  :Newi^cro() 
{ 

int  i,  imax; 
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CHList  ^‘pScriptList  (CHList  *)GetI)lgItQii(IIX:_SCRIPrjZSTSOT 
cm±Lt_SS  ^BditQrd  =  (CHEdit_SS  *)Geta)lgItem(Iir_SCRIPrjDIl^ 

CHEdit_SS  *pBditP  =  (CHEdit_SS  *)GetDlgItOT(IDC_SCRIPrj>)  ; 

for  (i=0,  lirax^nJ^ctuall^cro.gtd.GetU^perB^  ;  i<=irtBx;  1++) 
delete  {  (SQiid  *)  (mJVrtuaBticro.and.Get^^  ); 

n^ActuaJJ^cxo.mJiii^  =  BKLSE; 

iitiax=^ActualMacro .  atd.  Getl$perBound  ( )  ; 
for  (i=0,  iitvax^3ScriptList“>Get(^^  i<=iirax;  i++) 

pScriptList->DeleteItQn(0)  ; 
pScriptList->SetCurSel  {0)  ; 
pEbitQxd“>SetWindcWrext  (”")  ; 
pBctLtP->SetWijidcWrext  (”")  ; 

} 

void  OCHScriptsDlg:  :Cr]New{) 

{ 

int  nPesult,  ioresult=NCEREl; 

CString  strText,  strHeader; 

if  {rr^Mml!Xfecro.mJ::Has 

{ 

xiFesult  =  I^ssageBcK(’’I!he  current  rracro  has  been  changed.  \nDo  you  want  to  save  it  first?”, 
"Load  or  New  ]Xfecxo",I^_iacIOTSTICN  |  MBJfESNOCSNCEL)  ; 

if  (nKesult=  ID^ES) 

{ 

QnSaveO  ; 

NeuffecroO; 

} 

else  if  (hResult==IENO) 

NeuixfecroO ; 

} 

else  Nev^croO; 

} 

void  CX2IScriptsDlg:  :CnDelete{) 

{ 

char  buf  [256]  ; 
char  finaiTB[256]; 
buf[0]  -  *\0’; 

CString  strText; 

m_oj&i.nEilterIndex  =  mJil^criptType==^i™^  ?  IX_SCRIPr+2  :  IXJ®CBaf2; 

n^ofii.lpstrEile  =  buf; 
mjDfc.myEixBlle  =  sizeof  (buf) ; 
m_ofn.lpstrFileTitle  =  feartie; 
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m_ofn.nI>fexFileTitle  =  sizeof  (fname) ; 

mjDfn.lpstrIni1dLalI)ir  =  LPCTSTR(mJilScriptType==^^  ? 

(*pPEr)  [IX_SCRIPr]  .Dir  : 
i*p9Fl)  [IXJS^CPO]  .Dir)  ; 
mjDfn.lpstrTitle  =  "Delete  M^cro"; 

mjDfn.  Blags  =  OHN_FILEMJSTEXi:ST  |  OFNJ^mMKTEXrST  i  OENjnffiREADCNLY; 
mjofn.lpstrDefExt  =  IOTSTR(mJil^iptType^^  ? 

{*pPEI)  [IX_SCmPr]  .Ext  : 

{*pPFI)  [IXjyiACPO]  .Ext)  ; 


if  ((fetCpenBileNcDnne(aiijDfn)  ^ 

{ 

if  { !DeleteElle  (mjDfn.lpstrElle) ) 

{ 

stiText  =  CString{ "Couldn't  delete  ")  +  injofn-lpstrElle; 
lXfessageBax(strText,  "Delete  File",  lyBJCOOTNFMATICN  1  iyB_CK); 

} 

} 

} 

void  OCHScriptsDlg:  :CnLClickIiistQrd{) 

{ 

} 


MyTabDIg.h 


//  raytabdlg.h  :  include  file  for  all  tabbed  dialog  .h  files 


// 

//  class:  lyferrber  variable: 

tinclude  "rtBintab.h"  //  C^toiT^Dlg  n^TabDlg; 


tinclude  "chscript.h”  // 
tinclude  "chtlrritry.h”  // 
tinclude  "chiTBil.h"  // 
tinclude  "chmertDry.h”  // 
tinclude  "chctrl.h"  // 
tinclude  "chosctrl.h"  // 
tinclude  "chfilesy.h”  // 
tinclude  "chtaskct.h"  // 


OCHScriptsDlg 

in_ChDlgO; 

OCE^Teleretr^lg 

mJ^iDlgl; 

CCH^ilDlg 

rn_ChDlg2; 

OCHMsniDr^lg 

nUMlgS; 

OCHCcntrolDlg 

n^ChDlg4; 

OCHOSCcntrolDlg 

it^ChDlgS; 

1 

1 

in_ChDlg6; 

(XHTaskControIDlg  m_CliDlg7; 

{see  Gndview.h) 


C.  MISCELLANEOUS 


GndRC  Resource  file  for  Dialog  Editor 
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Resource.h 
Passwordh 
Password,  cpp 
PrefDlg.h 
PrefDlg.cpp 


Resource  variables  definition  include  file 
Include  file  for  Password  dialog 
Implementation  file  for  Password  dialog 
Include  file  for  Preferences  dialog 
Implementation  file  for  Preferences  dialog 


Gnd.RC 

//Mcrosoft  Visual  C++  generated  resource  script. 

// 

#include  '*mfcwidg.h" 

#inciude  "resource.h” 

///////////////////////////////////////////////////////////////////////////// 

// 

//  Generated  from  the  TEXTINCDGEE  2  resource. 

// 

#include  "afxres.h" 

///////////////////////////////////////////////////////////////////////////// 
#undef  APSTUDIO  PE?yrKLY  SYMBCLS 


#ifdef  APSTUDIOJDMm) 

///////////////////////////////////////////////////////////////////////////// 

// 

//  TEXmCLUEE 
// 

1  TEXmmiE  DISCARDAHTE 
BEGIN 

"resource. h\0" 

EM) 

2  TEXimXDEE  DISCARDABLE 
BEGIN 

"#include  ""afxres.h""\r\n" 

"\0" 

EMD 

3  TEmNCLODE  DISCARDABLE 
BEGIN 

"#include  ”"res\\Gnd.rc2""  //  ncn-Microsoft  Visual  C++  edited  resources \r\n" 
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"W" 

"idefine  J^JC)_SPLITIERJ^^^ 

"#defme  J^jqjXEJ^ESCOPC^ 

"#defiiie  JVHXJ^jnTOKERJ^^^ 

"#defiiie  J®CJ)OJHDPERIYJ^ES^ 

”#include  '"'aferes.rc"”  \011//  Standard  (xrrpcnents\r\n" 

"txnciude  ””af}^rint.rc""\011//  printing/print  preview  resources \r\n" 

”\0" 

END 

///////////////////////////////////////////////////////////////////////////// 

#endif  //  APSTUDIO  INVCKED 


///////////////////////////////////////////////////////////////////////////// 

// 

//  Iccn 
// 

IDR_MAINE™e  IOCN  DISCAREAELE  "resWCM.ioo" 

///////////////////////////////////////////////////////////////////////////// 

// 

//  Bitmap 

// 

im_MAINFRAME  BIMP  MOVEABLE  PURE  "resWtooIbar.tiTp" 

///////////////////////////////////////////////////////////////////////////// 
// 

//  Menu 

If 

IDR_MAINFPAME  mW  PREDQAD  DISCARDABLE 
BE)3IN 

POEUP  ”&File” 

BE3SIN 

MEHICTEM  "&New\tCtrl4N", 

MENUTTEM  "SCpen. .  .\tCtrl-K)", 

MEHUTEM  "&Save\tCtrl+S”, 

MENUTTEM  "Save  &As...", 

MENUTTEM  SEPARAICR 
MENUTTEM  ”&Print. .  AtCtrl+P", 

MEMIETEM  "Print  Pre&view”, 

MEIOTTEM  "P&rint  Setip. . 

MEMUITEM  SEEARATCR 
MEMJTTEM  "Recent  Elle", 


ID_FnE_NEW 

IDJEILEJDPEN 

ID_E1IE_SAVE 

IDJ1LE_SAVE_AS 

ID_FnE_ERINT 

ID_E1LEJRINTJRE7IEW 

ID_EIIEJPRINr_SE3UP 

ID_FTIEjy{R[}_FTLEl ,  (tRAVED 
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MEMJETEM  SEPARMPCR 
ME2SIUITEM  '*E&xit”, 

El® 

POPUP  "toess” 

BSOIN 

MENUTTEM  "Logcn", 
MENUTEEM  "Logoff", 

END 

MENUTTEM  "Prefererpes", 

POPUP  "sview" 

BEGIN 

MENUTTEM  "&TooIbar", 
MENUTTEM  "^Status  Bar", 

END 

POPUP  "&Help" 

BEGIN 

MEISIUTTEM  "&?toout  CM. . . ", 

END 

POPUP  "Dtog" 

BEGIN 

MENUTTEM  "Load  tfecro", 

END 

END 


ID  APP  EXIT 


IDjmSSJjOQCN 
ID_AOCESSJJOQOEr,  (SUPCfED 

ID  PREFERENCES 


IDJOEWJDOOLBAR 
ID  VIEW  SmUS  BAR 


ID  APP  ABOUT 


ID  IFBJG  lOALMACRO 


///////////////////////////////////////////////////////////////////////////// 

// 

//  Accelerator 

// 

lESyyiAINFRAME  ACCELERATCRS  PBEDOAD  MOVEABLE  PURE 
BEGIN 


"C", 

IDJETTJOOPY, 

VIRIKEY', 

(XNTROL, 

NOINVERT 

"N*', 

IDJEIIENEW, 

VIRTKET, 

OCNTROL, 

NOINVERT 

"0", 

ID  FIJ_E  OPEN, 

VIRTECEX, 

OCNTROL, 

NOINVERT 

"P", 

IDjmCE_PRINT, 

VIRTKEX, 

OCNTROL, 

NOINVERT 

"S", 

IDjnESAVE, 

VIRIKEY, 

OCNTROL, 

NOINVERT 

IDJEDTTJPASTE, 

VIRIKEY, 

OCMROL, 

NOINVERT 

VK_BACK, 

IDJDTTJJNDO, 

VIRTKEY, 

ALT,  NOINVERT 

VKjaELETE, 

ID_EDIT_CXJr, 

VIRIKEY, 

SHIFT,  NOINVERT 

VKJ5, 

IDC_SCRIPTJ0UITCEL, 

VIRIKEY, 

NOINVERT 

VKJ^, 

ID_NEXT_PANE, 

VIRIKEY, 

NOINVERT 

VK_E^, 

ID_PREV_PANE, 

VIRIKEY, 

SHIFT,  NOINVERT 

VK_INSERT, 

ID_EDTr_OOPY, 

VIRIKEY, 

OCNTROL, 

NOINVERT 

VKJNSERT, 

ID_EDIT_PASTE, 

VIRIKEY, 

SHIFT,  NOINVERT 

’X", 

ID^EDITJOUT, 

VIRIKEY, 

(OCNTROL, 

NOINVERT 

"Z", 

ID_EDIT_ONDO, 

VIRIKEY, 

OCNTROL, 

NOINVERT 
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EM) 


///////////////////////////////////////////////////////////////////////////// 

// 

//  Dialog 

// 

IEI)_ABCUrECK  DIALOG  DISCARDABLE  34,  22,  217,  55 
STYLE  DSJCTALFRAME  |  WSJOH3P  !  lAS_CAPnCN  |  WS_SYSMEMJ 
CAPnCN  "About  Gnd" 

EtNT  8,  "MS  Sans  Serif" 

BEGIN 

ICCN  irK_MAINEBAME,  IDC^SEATIC,  11, 17, 20, 20 

LTEXT  "Gnd  Version  1.0”,  IDC_STATIC,  40, 10, 119, 8 

LTEXT  "Ccpyri^t  Jens  Bartschat\251  1995",IDC_Smnc,40,25,119,  8 

DEEHJSHBUTTCN  ”CK”,  IDCK,  176, 6, 32, 14,WSJMUP 

END 

IDD_a!_SCRIPrS  DIALOG  18,  18,  397,  249 

STYLE  WSJHrLD 

EtNT  8,  *TyB  Sans  Serif" 

{ 

OCNTBOL  "%ssHList",  IDC^SCRIFTJlESTSCKEPr,  "HList",  HIS_BCR)ER3D  |  HLSJOimniEIGHT  !  WS_CHILD  I  WS_VISIELE  i 
WSJIABSTOP,  6,62,161,161 

OCNIRQL  "333;Nontal  Editing;HRl:HR2:HR3:HF2",  IDC^SCRIPTjrayiALEDIT,  "HButt”,  HBS_PADICBJnCN  1  HBSJTRANSPARENT  1 
HBS_LJUST  I  HBSJXWNPICS  (  HBSjmDADVANCE  i  HBSjmGTCN  |  WSJIHILD  [  WS_VISIBLE  |  WSJCABSTOP,  12,10,  56,12 
OCNTPOL  "333;E5^ress  Editiiig;mi:HR2:HR3:HR2",  IDC_SCRIPr_EXPBESSEDIT,  "HButt",  HBS_RADIOTITCN  |  HBSJTBANSPARENr  | 
HBS_UUSr  I  HBSJXWNPICS  1  HBSJ^OTQADTANCE  |  HBSJXBUTTCN  [  WSJ^CID  |  WS_yiSIB££  1  WSJEABSTOP,  12,24,  58,12 
OQTOX  ’liStat",  IDC_STAnC,  "HStat",  HSSJPAME  |  HSS_BUMP  |  HSSJTRANSPAREMr  1  WSJ3IELD  |  WS_VISIBLE,  6,7,68,32 
OGNIPQL  "433;Script;HRl:HR2:HR3:HR2",  IDC_SCRIPr_SCRIPr,  ^Tffiutt",  HBS^RADICBUTTCN  1  HBSJTRANSPARENT  !  HBSJXrUST  | 
HBSJXWNPICS  !  HBSjyCTQADVAMCE  |  HESJOTTITCN  |  WSjmJD  |  WS_VISIBLE  |  WSjrABSTOP,  85,10,38,12 
OCNTRCL  "433;iybcro;HRl:HR2:HR3:HR2",  IDC_SCRIPr_MACRD,  "HButt",  HBS_RADICHMCN  |  HBSJTRANSPARENT  |  HBSJLJUST  | 
HBSJXWNPICS  I  HBSJOraADTANCE  |  HBS_NCH7ITCN  |  WSJKLLD  |  W5_VISIBLE  |  WSJEABSTOP,  85,24,39,12 
CXMRDL  "HStat",  IDC_STATIC,  ^TEtat",  HSS_ERAME  1  HSS_BDMP  !  HSS_LEET  |  HSSJTRANSPARENT  i  WSJCHTLD  1  WSJ/ISIBLE, 
78,7,44,32 

CXNIROL  "441; Insert  fron  Edit  line;",  IDC_SCRIPr_INSERTEL,  "HButt",  HBS_LJUST  |  WSJHILD  1  WSJTISIBLE  1  WSJEABSTOP, 

6.229.69.14 

OCNERQL  "441;Cut  to  Edit  Line;",  IDC^SCRIPEJOTimi,  "HButt",  HBSJUUST  j  WSJ^niD  1  WS_yiSIELE  i  WSJEABSTOP, 

98.229.69.14 

OCNTPOL  "441; Insert;",  IDC_SCRIFT_INSEKr,  "HButt",  HBSJJUST  [  WSJUILD  !  WSJTISIELE  |  WSJEABSTOP,  191,229,37,14 
OCNEROL  "441;Bdit;",  IDC_SCRIPr_EDIT,  "HButt",  HBS_RJUST  I  WSJ3IELD  1  WSJ/ISIELE  |  WSJEABSTOP,  250,229,37,14 
OCNTPOL  "%SSHList",  IDC_SCRIPr_LISTayD,  "HList",  HLS_BCeiXR3D  |  HLSJOIENTHEiair  |  WSJHELD  1  WSJVTSIBLE  i 
WSJEABSTOP,  191,62,96,161 

OCNTPOL  "%sspurge_storedJ:elemetry",  IDC_SCRIPT_EDITCMD,  *’HE±Lt_SS",  HESJOCHSCRQLL  |  HES_BCroSP3D  1  WSJ3CELD  [ 
WSJ7ISIBLE  1  WSJEABSTOP,  6,47,86,12 

OCNTPOL  "441;Erase  Edit  line;",  IDC^SCRIPEJRASEIJNE,  "HButt",  WSJOTX)  1  WSJ7ISIBLE  |  WSJEABSTOP,  293,  47,  52,  12 
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CXMHX  "441;Load. IIX_SCBIPr_lJaAD,  "HButt",  HBSJJUST  1  WS^CHILD  [  WS_VISIBLE  |  WSJCABSTOP,  325,  80,  50,  14 
CXNrPCL  "441; Save;",  IDO_SCKCPr_SAVE,  "HButt",  HBS_IJUST  |  WSjmLD  |  WS_VISIBLE  |  WSjmBSIOP,  325,  109,  50,  14 
CCNTBQL  "441; Save  As...;",  IDC_SCRIPr_SAVEAS,  "HButt",  HBS_L0UST  I  WS_CHIID  |  WS_VISIELE  |  WSJIABSTOP,  325,  138, 
50,  14 

CCNira,  "441;New;",  IDC_SCRIPr_NEW,  "HButt",  HBS_LJUST  |  WS_CHILD  |  WSJ/ISIELE  |  WSJIABSTOP,  325,  167,  50,  14 
CCNIPCL  "441; Delete/",  Iir_SCRIPrjDEi:£!IE,  ^liButt",  HBSJjJUST  [  WSJOHILD  |  WSJ7ISIBLE  1  WSjmBSTOP,  325,209,50,14 
CCNTRDL  ”%ssHBdit_SS",  ICC_SCRIPr_P,  "HEdit^SS",  HESJOmSCEOX  |  HESJCHERSD  [  HES_FEADCNLY  i  WSJHTII)  1 
WS_VISIBLE  I  WSJTABSTOP,  94,  47,  193,  12 
} 

IWJMJXmPOL  DIALOG  DISCAPDABLE  18,  18,  397,  249 

STYLE  WS_CHILD 

KKT  8,  "MS  Sans  Serif" 

BEGIN 

OCNTEO:,  "RF  System",  IDC_STAnC,  "HStat",  0x251, 94, 7, 110,167 

OCNTROL  "Receiver",  IDCJSTATIC,  "HStat",  0x211, 98, 22, 49, 75 

CXOTPCL  "Transmitter",  IX^STATIC,  "HStat",  0x211, 151,22, 49, 75 

CXMRQL  "441;Mix\n#5;",  7000,  "HButt", WSJ3OT>  |  0xc86, 102,41,21,  22 

OCNIRCL  "441;Mix\n#6; ",  7001,  "HButt",  0xc86, 122, 41, 21, 22 

OCNIRQL  "441;Ife\n#5;",  7002,  "HButt", WSJIRCU^  1  0xc86,155,41,21,  22 

OCNIROL  "441;iyiix\n#6;",7003,  "HButt",  0xc86, 175, 41, 21,22 

CCNIROL  "441;INA\n#l;",7004,*mitt",WSj3ajP  |  0xc86, 102, 71, 21,  22 

OCNIROL  "441;INA\n#2; ",  7005,  "HButt",  0xc86, 122, 71, 21, 22 

OCNIRQL  ”441;HPA\n#3;",  7006,  "HButt", WSJ3RCUP  |  0xc86, 155,71,21,  22 

OCNTBOL  "441;HPA\n#4; ",  7007,  "HButt”,  0xc86, 175, 71, 21, 22 

OCNIRQL  "Power  Level : ",  IX_STAriC,  "HStat",  0x240, 102, 107, 41, 12 

OCNIRQL  "",7008,"HSpin",WSjrABSIDP  |  0x280,145,106,29,12 

OCNIRQL  "cB",  IX_STAnC,  "HStat",  0x240, 178, 107, 13, 12 

OCNIRQL  "441;Spread\nSpec±rum;",7009,"HButt",WSJ3?aB  |  0xc86,  102,144,47,22 

OCNIRQL  "441; Binary  PhaseXnKey  Shifting; ",7010,  "HButt", 0xc86, 148,  144,48,22 

OCNIRQL  "A",  IDC_SIAITC,  "HStat",  0x211, 212, 22,50, 64 

OCNIRQL  "B",  IX_STAnC,  "HStat",  0x211, 266, 22, 50, 64 

OCNIRQL  "441;Charge;", 7013,  "HButt", VBjIROaP  i  Qxca6,216,41,42,14 

OCNIRQL  "441;  Disctiarge; ",  7014,  "HButt",  0xc86, 216, 54, 42, 14 

OCNIRQL  "441;Of  fline; ",  7015,  "HButt",  0xc86, 216, 67, 42, 14 

OCNIRQL  "441;Charge;", 7016, "HButt", WSJSOJP  [  0xca6,270,41,42,14 

OCNTROL  "441;  Discharge; ",  7017,  "HButt",  0xc86, 270, 54,42, 14 

OCNIRQL  "441;  Offline; ",  7018,  ^TButt",  Qxc86, 270,  &7, 42, 14 

OCNIRQL  "441;Read; ",  7019,  "HButt",WS_TABSTaP,  99, 197, 45, 14 

OCNIRQL  "441;  Set; ",  7020,  "HButt",  WSJIABSTOP,  154, 197,45, 14 

OCNIRQL  "PANSAT  Clodc",  IDCJSTATIC,  "HStat", 0x251, 94, 177, 110, 67 

OCNIRQL  "Batteries",  IX^STATIC,  ’'HStat",  0x251, 208, 7, 112, 83 

OCNIRQL  "Transmit  Mode",  IX_STAnc,  "HStat",  0x211, 98, 125, 102, 45 

OCNIRQL  "WatdKtog",  irc_STATIC,  "HStat",  0x251,208, 94, 112, 80 

OCNIRQL  "441;Reset; ",  7021,  "HButt",  WSJEABSTOP,  214, 141, 45, 28 

OCNIRQL  "441;Stqp; ",  7022,  ''HButt",WSJEABSIOP,  269, 141, 45, 28 

OCNIRQL  "333;DCS  #l;HRl:HR2:HR3:HR2",7023,"HButt",WSJIABSIOP  i  0xlc33, 218, 109,50,12 
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CCNTRCL 


”333;DCS  #2;HRl:HR2:HR3:HI^’^7024/'HBatt*^WSJI!ABSTOP  |  0xlc33,218,123,50,12 
OCNTROL  "%a<#i:iTm:ss  Ddd,  Mtm  (±i,yy'^7025/'HEmt_SS'^  0x201, 99,  222,101,15 

OCNira  ’M41;(:n;'^7029,"HButt’^WSJ^aJP  I  0xc86,43,25,21,22 

CXNTRX  ”441;  Off;  ”,  7030,  "HButt",  0xc86, 63, 25,21, 22 

CCMPOL  "441;Cn;",7031,”HButt",ViB_aajP  1  0xc86, 43,55,21,22 

CXMPQL  "441;Off;",7032,"HButt",0xc86,63,55,21,22 

CCNTROL  "441;Qi;”,7033,”HBQtt”,WSJ3€UP  |  0xc86,43,85,21,22 

OCNTPCL  ”441;  Off; ",  7034,  "HButt",  0xc86, 63, 85, 21,22 

OCNTRX  "441;Cn;",7035,"HButt",TABJ3ROT  I  0xc86,43,115,21,22 

CCNTRX  "441;  Off; ",  7036,  "HButt",  0xca6, 63, 115,21, 22 

(XWIfOl;  "441;ai;",  7037,  "HButt", PiSjmJP  1  0xc86,43,145,21,22 

OCNTROL  "441;Off;  ",7038,  "HButt",  0xc86, 63, 145,21, 22 

OCNTBOL  "RF: ",  IDCJSOTIC,  "HStat",  0x280, 19, 31, 21, 12 

CXMHX  "MUX  A: ",  IirjTAriC,  "HStat",  0x280, 15, 61, 25, 12 

CCNTROL  ’MK  B: ",  Itx:_STAriC,  "HStat",  0x280, 15, 91,25, 12 

CCNTROL  "MStor  A; ",  IDC_STATIC,  "HStat",  0x280, 10, 121, 30, 12 

CCNTROL  "MStor  B:",IDC_STAnC, "HStat", 0x280, 12, 151, 28, 12 

CCNTROL  "HStat",  IDC_SrAriC,  "HStat",  0x212, 10, 142,76, 28 

OCNTRa  "HStat",  IDC^STATIC,  "HStat",  0x212, 10, 22, 76,28 

CCNTROL  *'HStat",  IDC_STATIC,  "HStat",  0x212, 10, 52,76, 28 

CCNTROL  "HStat",  IDC_STAnC,  "HStat",  0x212, 10, 82, 76, 28 

CCNTROL  "HStat",  IBC_STKnC,  "HStat",  0x212, 10, 112, 76, 28 

CCNTROL  "Etiwer  Switdies",  IDC_STATIC,  "HStat",  0x251, 6, 7, 84, 167 

CCNTROL  "sees  Parameters",  IDC_STAnC,  "HStat",  0x251, 6, 177, 84 ,  &7 

OCNTRa  "441;Pead; ",  7040,  "HButt",WSjrABSTOP,  23, 197, 50, 14 

CCNTRa  "441;l^te; ",  7041,  "HButt",  WSJTABSTOP,  23, 220, 50, 14 

CCNTRa  "Warn  Boot  DCS",  IDC_STAnC,  "HStat",  0x251, 323, 94, 68, 80 

OCNTRa  "333;DCS  #1;HR1:HR2:HR3:HR2",7042, 'mitt",WSJIABSTOP  |  0xlc33, 340, 109,36,12 

OCNTRa  "333;DCS  #2;HR1:HR2:HR3:HR2",7043,  »mitt”,WS_TABSTOP  |  0xlc33, 340, 123, 35, 12 

OCNTRa  "441;RCM\jiBoot;  ",7044,  "HButt",  WSJTABSTOP,  335, 141, 45,28 

OCNTRa  ^Tarperature  MGX", 7011,  "HStat",  0x251, 323, 7, 68, 83 

CCNTROL  "PeripheralXnCcntrol  Bus",  IDC_STATIC,  •’HStat",  0x251, 323,  177,68,67 

OCNTRa  ”441;  Init;",  7026,  ’•HButt",ViBJ[ABSTOP,335,211,45,28 

END 

IDD_MAIN  DIALOG  DISCARDABLE  42,  27,  441,  311 

STYLE  DSjmALERAME  |  l^jynNIMIZEBCK  |  WSJEOEUP  |  WS_VISIBIE  |  WS_CAPTICN 
CAPTICN  'tein  Dialog" 

EtNT  8,  "MS  Sans  Serif" 

BEGIN 

OCNTRa  "%kThh:nm:ss  Dc3d,  IHhm  cfci,yy",IDC_SYSTEMjnM^  0x201,102,289,101,15 

CCNTRa  "%tihh:rrm:ss",IDC_STOPWATm,"HE5±Lt_^^  |  0x281,214,289,48,15 

PUSHBDITCN  "",IDC_STATIC,0,0,400,265,NOr  WSJTABSTOP 

CCNTRa  "[DkRed];[64,0,0];HStat",IDC_SEND,"HStat",0x22,39,272,26,  14 

OCNTRa  "  [DkBlue] ;  [0, 0, 64]  ;HStat",  IDC_REnEIVE,  "HStat",  0x22, 39,  291, 26, 14 

OCNTRa  "Send",  106,  "HStat",  0x280, 4, 274, 30, 12 

OCNTRa  "Receive",  107,  "HStat",  0x280, 4,293,30, 12 
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"System  Tiire  &&  Date  :",IlX_STmC/'HStat",  0x240, 102, 275,  69,12 
"444;Start; ", IDC_Sa?yPT_STOEW^^  "HButt", WSJCRBSTOP,214,  272, 21, 14 
"441;Pause; ",  irx:jR?^SE_STOB®TCH,  "HButt", W5_GRODP  [  0xc86, 239, 272, 23, 14 
"441;  0; ",  IDCjyraO_0,  "HButt",  WSJEABSTOP,  400, 0, 41, 15 
"441;  1; ",  irx:j®CI^__l,  "HButt",  WSJD^BSTOP,  400, 15, 41, 15 
"441;  2; ",  IDCJ®CRO_2,  "HBatt",  WSJEABSTOP,  400, 30, 41, 15 
"441;3; ",  IDCjmq_3,  "HBatt",  WSJTABSTOP,  400, 45, 41, 15 
"441;  4; ",  IDCJ4?O0_4,  "HButt",  WSJEABSTOP,  400, 60, 41, 15 
"441;  5; ",  IDCjyraRD_5,  "HButt",lrtKjmBSOT,  400, 75,41, 15 
"441;  6; ",  IDC_m3^_6,  "HButt",  WS_™SOT,  400, 90, 41, 15 
"441;7; ",  IDCjmOJ?,  "IBiitt",W5jrABSTOP,  400, 105, 41, 15 
"441;  8;",  IDCW?O0_8,  "HButt",W5JEABS10P,  400, 120, 41, 15 
"441;  9; ",  irx:jMRO_9,  "HButt",WS_TaBSTOP,  400, 135, 41, 15 
"441;  10; ",  irx:j®aO_10,  "HButt",  WSJCaBSTOP,  400, 150, 41, 15 
"441;  11; ",  IDCJMq_ll,  "HButt",  WSJEABSTOP,  400, 165, 41, 15 
"441;  12; ",  irx:j®CRO_12,  "HButt",  WSJEABSTOP,  400, 180, 41, 15 
"441;  13; ",  IDCjyiACR)_13,  'TEutt",  WSJEABSTOP,  400, 195, 41, 15 
"441;  14; ",  IXjyiACRO_14,  "HButt",  WSJEABSTOP,  400, 210, 41, 15 
"441;  15; ",  IDC_MACPO_15,  "HButt",  WSJISBSTOP,  400, 225, 41, 15 
"441; . . . ; ",  IDCJ®CRO_NEXT,  "HButt", WS_™STOP,  400, 240, 41,  25 
"%84%ss%ss",IECJXMBOJOSEEm;,"H::cnb",W^^  i  0x111,  285,292,150,12 

*1og: ",  lEXJSTATIC,  "HStat",  0x240, 285,275, 16, 12 
"441;Pa;",IDC_IiX_PCL, "HButt", WSJ^  I  0xcS6,323,273,  23,14 
"441;User; ",  IDOJjTOJJSER,  "HButt",  0xc86, 345, 273, 23, 14 
"441;m; ",  IDCJjTOJXIACPO,  "HButt",  Qxc86, 367,273, 23, 14 

Iim^ijrEIZM^^  DIALOG  DISCARDABLE  18,  18,  397,  249 
STYLE  WS_CHILD  }  VS_ECWER 
EEM*  8,  Sans  Serif" 

BEGIN 

END 

imj:HjOSOCNTRaL  dialog  discardable  is,  is,  397,  249 

STYLE  WSJOKELD 

PCNT  8,  "MS  Sans  Serif" 

BEGIN 

OCNEROL  'User  ccntrol,  hahahaa!",IDC_STAriC,"HStat",0x262,7,6,  129,47 

OCNTROL  "333;Drcp  &&  Loci:out;HRl:HR2:HR3:HR2", 8000, ’’HButt",  WSJEABSTOP  |  0xlc33, 66, 10, 66, 12 

OCNTRCL  "333;Lockout;HRl:HR2:HR3:HR2’’,8001,”HButt",WSJEABSTOP  |  0xlc33, 66, 24, 66, 12 

OCNTROL  ’'333;OiLock;HRl:HR2:HR3:HR2",  8002, ’’HButt",  WSJEABSTOP  1  0xlc33, 66,38,66,12 

OCNTROL  "Foreign  Users: ",IDC_STAnc,  "HStat", 0x240, 13, 11, 48, 12 

CCNTROL  '’EVENIIOG",8003,''HGrid",WSJBCREER  |  WSJ7SCRQLL  |  WSJEABSTOP  i  Qx2b81,7,78,183,136 

OCNTROL  "Evait  Log", IEC_STAnC, "HStat", 0x240, 7, 63, 37, 12 

OCNTROL  "441;Read; ",  8004,  "HButt",  WSJEABSTOP,  31,224, 50, 14 

OCNTROL  "441; Purge  All; ",  8005,  "HButt", WSJEABSTOP,  112, 224, 50, 14 

CCNTROL  "%sshh:nm:ss  ap  Ddd,  Mtm  dd,yy",8006,’’HBdit_SS",  WSJEABSTOP  I  0x280,94,62,96,12 


OCNTROL 

OCNTROL 

OCNTROL 

OCNTROL 

OCNTROL 

CCNTROL 

OCNTROL 

OCNTROL 

CCNTROL 

OCNTROL 

CXKFROL 

OCNTROL 

CCNTROL 

OCNTROL 

OCNTROL 

OCNIRCL 

OCNTROL 

OCNTROL 

OCNTRa 

OCNTROL 

OCNTROL 

OCNTROL 

OCNTROL 

OCNTROL 

OCNTROL 
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CXUTFOL  "Start: ",  8007,  "HStat",  0x240,75, 63, 20, 12 

CarrPOL  "441/A±i. . . ; ",  8008,  "HButt", WSJEABSTOP,  215, 224, 36, 14 

aCNTPCL  "441;  Itelete; ",  8009,  "HButt",  WSJDffiSTOP,  258, 224, 36, 14 

COSTTROi  "441;List; ",  8010,  "HButt",  WSJEABSTOP,  301,224, 36, 14 

CXNIPOL  "441/Purge  AU;",8011,"HButt",ViSJI!ABSTOP  |  0x20,344,224,  36,14 

CCNTROL  "TM™",8020,"HGrid",WS_BOTER  |  WS_VSCRDIX  |  WSJEABSTOP  |  0x2b81,206,78,183,136 

CTNTRX  "Time-Tagged  Cornends",  IDC_STATIC,  "HStat",  0x240, 206, 63,  84, 12 

El® 

lEDJiyyiAIL  DIALOG  DISCARDABLE  18,  18,  397,  249 

STVLE  WS_CHILD 

ECNT  8,  "l^B  Sans  Serif" 

BEGIN 

CCNTRCL  "PANSAT  tfeil  Directory: ",  IDC_STATIC,  "HStat",  0x240, 6, 81,  77, 12 

CCNIRQL  "%ssHIdst",IDCjyiAIL_IISTyiArL,"HIist",WS_^^  j  0x10,6,  96,91,147 

CCNTPCL  "%ssHList",IDCjraLJJSIMUIZII£,"HList",WSJEAB  |  0x110,202,23,189,220 

CCNTRX  "%ssHEdit_SS",IDCjy]ArLJMm£NAI^J'HBdLt_^  WSJCABSTOP  |  0x2280,202,6,91,12 

OCNTROL  "441; Get  Directory;  ",IDCjyiAILjGETDIR,  "HButt ”,WSJIA^^  |  0x20,115,119,55,14 

OCNTROL  "441;  Get  " ,  IDGjyiAIL_FEAE3yiSG,  "HButt", WSJEABSTOP  1  0x20, 115, 96, 55, 14 

CCMHX  "441;Add  lyfeil;",  IIX:j^AILJ®nxeG,  "HButt", WSJI^^  I  0x20,115,229,55,14 

CCNIRCL  "441;Dslete  lyfeil; ",  IDCJMJXLMSG,  "HButt", WSjmBSTOP  i  0x20, 115, 163, 55, 14 

CCNIRCL  "441;  Purge  An  ^fail;",IDCjrajKB2a^,"HButr^^  WSJEABSTOP  1  0x20,115,186,55,14 

OCMTOL  "HEdit_SS",IDCjra0_EIO5,'lIEmt_SS",WSJEABSr0P  |  0x280,  36,6,141,12 

OCNTRCL  "HEdit__SS",IDC_MAILJIO,"HEdit_SS", WSJEABSTOP  ]  0x280,36,  22,141,12 

CXITTROL  "%tlimv^dd/yy  hh:iim  ap",IDCJ^mjrM,"HB^  WSJEABSTOP  |  0x280,36,38,62,12 

CCNTRCJL  "HEait_SS",ircjyiAIL_SUBJBCT,"HBdit_SS",WSJE  [  0x280,36,54,141,12 

OCNTROL  "Fran: ",  IDC_SIATIC,  "HStat",  0x280, 6, 7, 26, 12 

OCNTRCL  "To : " ,  IDC_STAnC,  "HStat",  0x280, 6, 23, 26, 12 

OCNTROL  "Bate : ",  irc_STATIC,  "HStat",  0x280, 6, 39, 26, 12 

OCNTROL  "Subject: ",  IDC_SIATIC,  "HStat",  0x280, 6, 55, 26, 12 

END 

imjiHJEyEPY  DIALOG  DISCARDABLE  18,  18,  397,  249 
STYLE  WSJHELD  |  WS_BCFEER 
EONT  8,  "te  Sans  Serif" 

BEGIN 

OCNTRCL  ’^HStat",  irXJSTATIC,  "HStat",  0x262, 93, 7, 112,40 

OCNTRCL  "333; im*HRl:HR2:HR3:HR2",  9000, ’mitt", WSJSRCUP  [  WSJEABSTOP  |  0xlc33,135,13,27,12 

OCNTROL  "333;RCM;HR1:HR2:HR3:HR2",  9001,  "HButt", WSJEABSTOP  |  0xlc33,135,30,26,12 

OCNTRCL  "333;  SRAM;HR1:HR2:HR3:HR2",  9002,  "HButt", WSJEABSTOP  !  0xlc33, 170, 13, 31, 12 

OCNTRCL  "333;FLASH;HR1:HR2:HR3:HR2",  9004,  "HButt", WSJEABSTOP  1  Qxlc33, 170, 30, 32, 12 

OCNTRCL  "HStat",  IIXJSTATIC,  "HStat",  0x262,209, 7, 174, 40 

OCNIRCL  ’'441;mss\nA;",  9010,  "HButt", WSJSROUP  [  0xc86,215,13,28,  28 

OCNTRCL  "441;Jfess\nB; ",  9011,  "HButt",  Qxc86,242, 13, 28, 28 

OCNTRCL  "441;AM[K\nA; ",  9012,  "HButt",  0xc86,269, 13,28, 28 

OCNTROL  "441;AiyiUX\nB; ",  9013,  "HButt",  0xc86, 296, 13, 28, 28 

OCNTROL  "441;EPS; ",  9014,  "HButt",  Qxc86, 323, 13, 28, 28 
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OCNTRCL 


'441;FF\nSystem; ",  9015,  "HButt",  0xc86,350, 13,28,28 
OCNTROL  "HStat",  IDC_SimC,  "HStat”,  0x262, 6, 7, 83, 40 

OCNTROL  "333;20“Bit;HRl:HR2:HR3:HI^”,9020,'mitt",WSJ]RC)UP  1  WSJEABSTOP  |  0xlc33,50,13,35,12 

CXMPOL  "333;Seg:Off;HRl:HR2:HR3:HR2",902l,"HButt",1>®JC^^  i  0xlc33,50,30,37,12 

(XNmX  ^Tyfenory : ",  IDC_STAnC,  "HStat",  0x240, 99, 14, 28, 12 

CCNIRX  "Mtess : ",  104,  "HStat",  0x240, 12, 14, 30, 12 

OCNTRX  ’T!®CDIT",9040,"HGrid",WS_BOT  |  WS_VSCraL  |  WSJEABSTOP  |  0x490a,6,67,261,176 

OCNTROL  "441;Eait;",9050,*mitt",VIS_a€UP  1  0xc86,309,68,28,28 

OCNTROL  "441;  View; ",  9051,  ’TButt",  0xc86, 336, 68,28,28 

OCNTROL  "lyfertory  Block",  IDCJTATIC,  "HStat",  0x240, 6, 55, 50, 12 

OCNTROL  "441;Write\rMxiLfied\xBytes; ",  9062,  "HButt",WSJERBSTOP,  277,210, 50,33 

OCNIPOL  "%mI0|",107,"HEmt_SS",WSjrRBSTOP  [  0x2280,285,125,50,12 

OCNTROL  "Bytes  modified: ", IDC_srAnc,  "HStat", 0x240, 285, 113, 50, 12 

OCNTROL  "Bytes  written: ", IDC_SmiC, "HStat", 0x240,285, 153, 50, 12 

OCNTROL  "%nu|0|",105,"HE3ctLt_SS",lABjr?©STO  [  0x2280,285,165,50,12 

OCNTROL  "441;Oancel; ",  106,  "HButt",WSjr2^BSTOP,339, 124, 50, 14 

OCNTRX  "441;Reset/",108,"HButt",WSJTKBSTOP  |  0x20,339,164,50,14 

OCNTROL  "441;Re-Read\nVisible\nBlock; ",  9063,  "HButt",WSjrKBSTOP,  338,210, 50,33 

END 

IDDJ31JElIESYSrEM  DIZ^IOG  DISOftRDRBLE  18,  18,  397,  249 

STYLE  WS_CHIID 

FONT  8,  "MS  Sans  Serif" 

BEGIN 

OCNTRCEi  "PANSAT  File  Directory: ",  IDC_STAnC,  "HStat",  0x240,7, 6, 77, 12 

OCNTROL  "%ssHList",IDO_EILEJl[STETI£,"HI^St",WSjr]ABSID  [  0xal0,7,20, 91,222 

OCNTROL  "441;Read  Directory;  ",ID0_EII£J3nDIR,’TButt",V^^  |  0x20,116,118,55,14 

OCNTROL  "441;Read  File; ", IDCJT[£:jREM)FILE,  "HBiitt",^KJEABSIOP  |  0x20, 116, 95, 55, 14 

OCNTROL  "441;Write  Flle;",IDCJTIEJ^DFXI£,"HButt",ViB^^  [  0x20,116,228,55,14 

OCNTROL  "441;Delete  File;",irGJTIEJ3EIFIIE,"HButt",ViB^^  1  0x20,116,162,55,14 

OCNTROL  "441; Purge  All  Files ;",  IDO JIIE J^JRSmE, ’1^  IaISJEABSTOP  |  0x20,116,185,55,14 

OCNTROL  "Selected  File  (s) : ",  IDC^SIATIC,  ’TBtat",  0x240, 201, 6, 77, 12 

OCNTROL  "%ssHList",irx:_FriE_SEIHrimF:,’7^  1  0xal0,201,36,91,206 

OCNTROL  "HCalto",IDCJTLE_SELE^IOC^eD,"HCc^to  |  0x119,  201,20,91,12 

END 

iroj^JASKOCNTRCL  DIALOG  DISCAREJ^LE  18,  18,  397,  249 

STYLE  WSJKCLD 

FCNT  8,  *'MS  Sans  Serif" 

BEGIN 

OCNTROL  ’rnASEO",IDOJCASKj3I[DI!ASK,"HGrid",WS_E^  |  WS_VSCROLL  [  WSJTfiBSTOP  |  0x2988,6,77,150,166 

OCNTROL  "Add  iieans . . .  ” ,  IDC_STAnO,  'TiStat",  0x262, 6, 7, 129, 47 

OCNTROL  "333;Add  &&  Start  Task  &&  Get  List;HRl:HR2:HR3:HR2", 

IDCJTASKJ^ICmcO, ’TIButt",  1  0xlc33,36,ll,97,12 

OCNTROL  "333;Add  &&  Get  Ust;HRl:HR2:HR3:HR2",irCJIASKJ^IGLr£T,"HBatt",I®JI3^^  1  0xlc33,36,25, 97,12 

OCNIPOL  "333;Add;HRl:HB2:HR3:HR2",IDCJ[ASKJ^IQArB,'TButt",  WSJCABSIOP  |  Qxlc33,36,39,97,12 

OCNTROL  "Add: ",  IDCJTATIO,  ^TlStat",  0x240, 12, 12, 16, 12 
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OCNTFO:.  "441;A±i; ",  IirjCASK_AED,  "HButt",WS_TABSIOP,  164, 77, 69, 14 

CCNTFQL  "441;Delete  Task; ",  IITjmSKJlIEIE,  "HButt", WSJTSBSTOP,  164, 229, 50, 14 

CXMPQL  "441;Get  Tasklist; ",  ITCJIJ^KJSEILIST,  "HButt", WSJEABSTOP,  164, 150, 50, 14 

COmVL  "TASKIST",irx:jI2^J3PIDFri£S,"H^  I  VKJ/SCRQLL  |  WSJEABSTOP  |  0x2988,242,97,99,146 

OCNTRQL  "%ssHEjciLt_SS",irrjr2^JDITm£,’T!0dit_SS",V^^^  |  0x280,242,77,99,14 

OCNTROL  "441;Ioaci. . , ;  IirjEASK_lJClAD,  "HButt",WS_TaBSTOP,  349, 97, 41, 14 

CaTOX  "PMSKT  Task  Ust",  IIX:_STAITC,  "HStat",  0x240, 8, 63, 63, 12 

OCNTROL  "Available  Task(s)  ",IDC_STATIC,  "HStat", 0x240, 242, 63,62,12 

IWJ^PEmWES  DIALOG  DISCARDABLE  0,  0,  186,  173 

STYLE  DSJOXLEPAiyE  |  WS_POPUP  |  WS_VISIBLE  |  WS_CAPnCN  |  WS_SYSMEMJ 

CAPITCN  "Preferences" 

Erwr  8,  "MS  Sans  Serif" 

BEGIN 

IXHHJSeBOTrCN  "CK",  IDCK,  15, 148, 50, 14 
POSHBUnCN  "Cancel",  IDCANCEL,  115, 148, 50, 14 

EDITTEXT  IDCJDITl,  64, 15, 112, 13,ESjy7IQHSCRC!LL 

EDITTEXT  IDC_EDIT2,64,31,112,13,ESjyjiaiSCPm 

EDITTEXT  IDCJDIT3 , 64, 47, 112, 13,  ESJ^TTCHSCRCaX 

EDITTEXT  IDC_EDIT4, 64, 63, 112, 13,E3jy7ICHSCRaLL 

EDITTEXT  IDC_EDIT5, 64, 79, 112, 13,  ESJ^JimSCROLL 

EDITTEXT  IDC_EDIT6, 64, 95, 112 , 13,  ESjyOICHSCBCSLL 

EDITTEXT  IDCJEDIT?,  64,  111,  112, 13,  ES_A£JTCHSCRC5LL 

RTEXT  "Scripts : ",  IDC_STATIC,  8, 18, 51,13 

KTEXT  "jyfecros : ",  IDC_STAnc,  8, 34, 51, 13 

KTEXT  "Telemetry  Data: ", IDC_STAnc, 8, 50, 51, 13 

RTEXT  "User  Log: ",  IDC_STAnC,  8, 66, 51, 13 

KTEXT  "Task  list: ", IDC_STAnC, 8, 82, 51, 13 

KTEXT  "IN  Data:",IDC_STAITC,8,98,51,13 

KTEXT  "OUT  mta:",IDC_STAnC,8,114,51,13 

(TCOPBCK  "Directory  Settings",  IDC^STATIC, 5, 1, 176, 137 

END 

imjJSERLOGIN  DIALOG  DISCARDABLE  18,  18,  142,  92 
STYLE  DS_MXALEKAME  1  WSJEOEUP  |  WSJXPTTCN 
CAPnCN  "PANSAT  GroundstatiCTi  User  Login" 

BEGIN 

OCNTROL  "%ssjbartschat",IDCjLa3NJL0GIN,’TlEait_SS’^^  i  0x280,56,28,77,12 

CCNTRQL  \  0x280,56,46,77,12 

CCNTFCL  "441;Ok;",IDCK,"HButt",WSJEABSTOP  1  0x1,13,70,50,14 

OCNTROL  "441;Cancel;",IDCANCEL,’TiButt",WSjrABST^  1  0x20,78,70,50,14 

OCNTROL  "Login: ",  IDC_STAnc,  "HStat",  0x240, 14, 29, 40, 12 

OCNTROL  "Password: ",  IDC_STAnc,  "HStat",  0x240, 14, 48, 36, 12 

OCNTROL  "Please  enter  your  login  and  password",  IDC_STAnc,  "HStat",  0x240, 10, 10, 125, 12 
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///////////////////////////////////////////////////////////////////////////// 

// 

//  Versioi 

// 

VSJ/ERSICN_INFD  VERSICNINHO 
HXLEVERSICN  1,0, 0,1 
iraxcrvERsiCN  i,  0,0,1 
FnmflGSMASK  0x3fL 
#ifdef  jrajs 
FUEFIAGS  OxlL 
#else 

yTT.RFTary?  OxOL 
#endif 
FUEOS  0x4L 
FUEETO:  QxlL 
FUESUBTYPE  OxOL 
BEGIN 

BKX3C  "StringELLelnfo" 

RFGIN 

BUXK  ”040904b0'' 

BEGIN 

VNIE  "Cotpan^i^Jarte",  ’TSIPS  SS?G  (Gemen  branch)  \0" 

VT^LUE  "FlleDascripticn",  "ERNSOT  GToundstaticaiXO" 

VALCE  "EileVersiai”,  "1,  0,  0,  1\0" 
vmJE  ’’IntemaaJNare",  "GND\0" 

VALUE  "LegalCcpyri^t",  "Ccpyri^t  \251  1995  Jens  Bartschat\0" 
VALUE  ”QrigimlEilename",  "(2©.EXE\0” 

VALUE  "ProductNarre",  "PANSAT  GroundstaticnXO" 

VALUE  "ProdactVersiai”,  "1,  0,  0,  1\0" 

END 

END 

HLGCK  ’VarEllelnfo" 

BEGIN 

VALUE  *T?ranslaticn",  0x409,  1200 

END 

EM3 


///////////////////////////////////////////////////////////////////////////// 

// 

//  String  Table 

// 

STRBGEABLE  PRELOAD  DISCARDABLE 
BEGIN 
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IDR  MAINFRAME 


"RfiNSAT  GroundstaticnXn  GtoundstationNn  Groundstatian  Docurnent\n\n\n 
Groirxistatiai.Dxrurim^  GrourxJstation  Document" 

SSD 

STRECTAELE  EBEDOAD  DISCARDABLE 
BEJSIN 


AEXJiDSJ^PjrriLE 

"PANSAT  Groundstation" 

AEXJ[DS_IDIf3yESSAGE 

"Ready" 

EM} 

STRINGIABLE  DISCARDABLE 

BEGIN 

ID^IE^ICATCRJEXT 

"EXT" 

IDJE®ICAICR_CAPS 

"CAP" 

ID_INDICAiaR_NGM 

ID_INDICATCR_SCRL 

"SCRL" 

ID_Il®ICATCR_OVR 

"O/R" 

IDJCNDICAIOyREG 

"BEC" 

END 

STRINSTAELE  DISCARDABLE 

BEGIN 

lE^ETLE  NEW 

"Create  a  new  document  \riNew" 

ID_FILE_OPEN 

"Cpen  an  existing  documentXnCpen" 

IDJFTLEJCDOSE 

"Close  the  active  ckxnjmentXnClose" 

ID_BTLE_SAVE 

"Save  the  active  document\nSave" 

ID_EILE_SAVE_AS 

"Save  the  active  document  with  a  new  nameNnSave  As" 

ID_ElIE_PAGE_SErUP 

"Change  the  prmting  qptionsNnPage  Setip" 

ID_FII£JERINT_SETOP 

"Change  the  printer  and  printing  cpticnsNnPrint  Setip" 

ID_FILE_PRINr 

"Print  the  active  documentXnPrint" 

ID_BTIE_PRmr_PREVIE^ 

"Display  full  pages\nPrint  Preview" 

EM} 

STRINGEABIE  DISCARE?\BLE 

BEGIN 

IDJPPJWJT 

"Display  program  infoinaticn,  versioi  nurrber  and  ccpyri^tNnAbout' 

ID_APP_EXrT 

"Quit  the  ^licaticn;  prarpts  to  save  documentsNnEixit" 

EM) 

STRIN3EABLE  DISCARDABLE 

BEGIN 

ID  ETLE  MRU  ETLEl 

"Cpen  this  document" 

ID  ETLE  MRU  FTLE2 

"Cpen  this  document" 

ID  ETLE  MRU  FELE3 

"Cpen  this  document" 

ID  FTT.F.  MFO  FIIE4 

"Cpen  this  document" 

WD 
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SriRINGimE  DISCARDftBIE 
BEGIN 

IDJ®Xrj>ME 

IDJ>REV_PANE 

EM) 

STRIICTABIE  DISCARDABtE 
BEHCN 

IDjra^CWjSEIJT 

EM) 

STRINGEABLE  DISCARDABLE 
BE33IN 

ID_EDIT_CLEAR 

IDJDITJXE?\R_AIIi 

IDJEITJDOPY 

ID^EDITJGJT 

ID_EDnVEIM) 

ID_EDITPASTE 

ID^EDITJCRETff 

ID_EriT_REIIACE 

IDJEDIT^SEIOTJilli 

IDJDITJMO 

IDJDITREDO 

EM) 

SIRINGIABLE  DISCARIMLE 
BEGIN 

IDjm?jrOQE£AR 

IDjraffJSIAIUS_BAR 

EM) 

STRINGEABLE  DISCARDABLE 
BEGIN 

AEX_IDS_SCSIZE 

afxj:ds_scdo® 

AEXJlI)S_SCMrNIMrZE 

AEXJiDS^SCMAXMTZE 

AEXJI)S_SCMXrVim®^ 

iffiCJ[DS_SCPREMMX)W 

aexj:ds_sccijcse 

EM) 

SIRINGIABLE  DISCARDABLE 
BEGIN 

AEXJEDSjSCRESrrCRE 
AEX  IDS  SCTASKLIST 


'’Switch  to  the  next  vdndow  paneNhNext  Pane" 

"Switch  back  to  the  previous  windcw  paneNnPrevious  Pane" 


"Split  the  active  windcw  into  panesNnSplit" 


"Erase  the  selectionNnErase" 

"Erase  €verything\nErase  All" 

"Copy  the  selection  and  put  it  on  the  ClipboardXnCcpy" 
"Cut  the  selection  and  put  it  on  the  ClipboardXnCut" 
"Find  the  specified  textXnEind" 

"Insert  Clipboard  oontentsNnPaste" 

"Repeat  the  last  acticn\nRepeat" 

"Replace  specific  text  with  different  textNnReplace" 
"Select  the  entire  documentXnSelect  All" 

"Undo  the  last  actionNnUndo" 

"Redo  the  previously  imdcne  acticn\nRedo" 


"Shew  or  hide  the  toolharViToggle  ToolBar" 

"Show  or  hide  the  status  bar\nToggle  StatusBar" 


"Change  the  windcw  size" 

"Change  the  windcw  position" 

"Reduce  the  windcw  to  an  icon" 

"Enlarge  the  windcw  to  full  size" 

"Switch  to  the  next  document  windcw" 

"Switch  to  the  previous  document  windcw" 

"Close  the  active  window  and  prompts  to  save  the  documents" 


"Restore  the  windcw  to  normal  size" 
"Activate  Task  List" 
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END 


SIKENGIABLE  DISCftPDftELE 
BEGIN 

AHX_IDS_PREVIEWj:IjOSE  "close  print  preview  modeXnCanoel  Preview" 

EM) 


STRINGIABLE  DISC?iRn?^BIE 
BEGIN 

IDJOTSSJjCQCN 

IDJOTSSJjOQOEF 

ID_EF?EFERE13CES 

EM) 


"Log  on  as  a  registered  user" 
"Quit  your  user  acxxmt" 

"Set  Directories" 


#ifndef  APSTUDiq_INVa<ED 

///////////////////////////////////////////////////////////////////////////// 

// 

//  Generated  fron  the  TEXTINdUEE  3  resource. 

// 

tindude  "res\Gnd,rc2"  //  ncruyticrosoft  Visual  C++  edited  resources 

#define  J®(jq_SPIX[TERJ^^^ 

#defme  J®CJ«DJXEJRES^^ 

#define 

#define  J^ySDJTOPERTYJ^^^ 

#include  "aferes.rc"  //  Standard  ooipoients 

toclude  "afj^rint.rc"  //  printing/print  preview  resources 

///////////////////////////////////////////////////////////////////////////// 

#endif  //  not  APSTODIO  IWCKED 


Resource.h 

//{ {NOJEPEMraCIES} } 

//  Microsoft  Visual  C++  generated  include  file, 
//  Used  by  QO.FC 

// 

#define  IK)J©OUrBCK 

100 

#define  lERJOTIEB?^ 

128 

tdefme  IDDJJSEKDOGm 

129 

#define  IIBJ^iJXNnCL 

130 

#define  lWJ^J13£S’£SIm 

131 

#defiiie  IEDJCH_MAIL 

132 

idefine  IWJBJSCXmPOL 

133 

#defiiie  IIX>_CH_SCRIPIS 

134 

#define  in>  CH  TASKOCNTBOL 

135 

139 


#defijne 

IDDJBJELHyEIRY 

136 

tdefine 

iDDj^yyecpy 

137 

#defijae 

140 

#de£me 

IDD_PREFERE25:2S 

141 

#defiiie 

IDCJjCmrjJOGIN 

500 

#define 

501 

#defij:ie 

3ir_SYSTEM_TIME 

900 

Idefine 

iir_STOEmrcH 

901 

#define 

IIX_SmPT_STOEWAI^ 

902 

#defme 

IDCJ’AUSE_STOBOTCH 

903 

#dejEine 

IDC_SEND 

997 

#define 

IDC_REnEIVE 

998 

#defiiie 

IDCJXMBOJJSERLOG 

999 

#define 

IDCJDDGJJSER 

1000 

#define 

IIXJjOGJ^CBO 

1001 

#define 

IIXJjOGJCL 

1002 

#defiiie 

IDC_M?CK)_0 

1050 

#define 

lUZJSPCPOJ. 

1051 

#defiiie 

irrj®CBq2 

1052 

#define 

IIXJdACBOj 

1053 

#define 

IDC_MACBO_4 

1054 

idefine 

IIXJ4ACRO_5 

1055 

idefine 

IDCJ©CRD_6 

1056 

idefine 

IIX:_MftCRO_7 

1057 

idefine 

I1XJ©CR0_8 

1058 

idefine 

IDCJ®CRO_9 

1059 

idefine 

IDCJ®CRO_10 

1060 

idefine 

iix:j®CRO_ii  ' 

1061 

idefine 

ircjmyoji 

1062 

idefine 

iirjyirao_i3 

1063 

idefine 

Iirj®CRp_14 

1064 

idefine 

IIXjyiACBp_15 

1065 

idefine 

1066 

idefine 

IDCJEDITl 

1067 

idefine 

rDCJlDIT2 

1068 

idefine 

IDC_EDn3 

1069 

idefine 

IDC_EDIT4 

1070 

idefine 

IDCJDITS 

1071 

idefine 

IDC_EDIT6 

1072 

idefine 

IDC_EDrr7 

1073 

idefine 

iir_scRiprjOTyi^^ 

2000 

idefine 

Iir_SCRIPT_EKERESSEDrr 

2001 

idefine 

irx:_scRipr_scRipr 

2002 

idefine 

irr_SCKEPrj4ACRO 

2003 

idefine 

iix:_sa^prjLisaH3^ 

2004 

idefine 

iir_scKEPr_LiSTCiyD 

2005 

idefine 

irx:_scKEpr_EDiTCiyD 

2006 

140 


#defme  IDC_SCKi:pr_P  2007 

#define  IIX:_SCKrPr_EE^ASELINE  2009 

#define  IIX:_SCRIPrj2JSEBIEL  2010 

#defme  IDC^SCBIPTjOTraL  2011 

#defijne  Iir_SCRIET__INSEKr  2012 

#de£me  IDC_SCRIPr_EDIT  2013 

#define  Iir_SCK[Pr_ljQftD  2014 

#define  IEX:_SCRIPT_SAVE  2015 

#define  Iir_SCRIPr_SAVE3^  2016 

#defiae  Iir_SCRIPr_NEW  2017 

#defiiie  IDC_SCRIPr_DELE:rE  2018 

#defijne  irrjTT^SKJ^ICHJIO  3000 

#define  IIXjr^K_RADiaLIST  3001 

#define  IirjEASK_RADIGMD  3002 

#defme  irx:jr?^K_GRIDEASK  3003 

#de£me  IIXJD^JS^DEILES  3004 

#define  IirjD^JDrmiE  3005 

#defme  3006 

#define  irrjraSKJETLIST  3007 

#defme  IICJ3^J)ELEJ£  3008 

#define  IDCJIJ^K_L3RD  3009 

#deflne  IIX:jML_FPCM  4000 

#dGfiQe  IDCJOTjJEO  4001 

#defme  IDCJ^ILJEIME  4002 

#define  IXjraL_SUBJEr:T  4003 

#de£me  IDC jym ijyiA.TT jnr FJ\iaMR  4004 

#define  IIX:jyiAILJLISIM^^  4005 

#defme  IirjyiAIL_IJSrn^  4006 

fdefine  IIX:jraL_GErDIR  4007 

#de£me  ircj^AILJ^EMXBG  4008 

#defijnie  IX_MAILJOX©3  4009 

#defHie  IlXjyMLjraijy^  4010 

tdefine  4011 

#define  Iir_FmjZSrFlLE  5001 

#define  irc^FIIfiJETOIR  5002 

tdefine  irx:jFII£J^E5yOFILE  5003 

#defixie  irx:_FILE_ADDFILE  5004 

#define  IJXIJTLEJELJETLE  5005 

tdefiJie  IDC_FIIE_PUR3EF1LE  5006 

tdefine  IIX:_FII£_SEIH3ITILE  5007 

tdefine  IDC_EIIE_SELECira  5008 

#defiiie  ID_A0CESS_L0GCN  32771 

idefine  IDJCCESSJjCGOFF  32772 

#define  IDJ>REEERENCES  32773 

#define  IDjmX5jmm3C)  32774 

//  Ne>d:  default  values  for  new  objects 


141 


// 

#ifdef  APSIODIO_INVCKED 
#ifndef  APSTUDIO  READCNLY  SYMBCSLS 


#define  J^_3DJXNIR3LS  1 

#define  J^J«rjRESO[]I^J^^  139 

#defiiie  j^j^jxmm)_ymE  sziie 

#deflne  J\ESJCXTJXNTRO^^  5000 

#define  JiBSJJEXT_smEDjmm  101 

tendif 
#endif 


Password.h 

//  password. h  :  header  file 

// 

///////////////////////////////////////////////////////////////////////////// 

//  CPasswDrdOlg  dialog 

class  CPasswordDlg  :  .public  CDialog 

{ 

//  Ozanstruction 
public: 

CPasswDrdDlg(CWnd*  pParent  =  NULL);  //  standard  constructor 

//  Dialog  Data 

//{ {AFXJDKm(CPasswDrdDlg) 
enum  {  II©  =  imjJSERDOGIN  }; 

//  NCTEE:  the  ClassWizard  will  add  data  inenbers  here 
//}}AEX__DAIA 


//  Overrides 

//  ClassWizard  generated  virtual  function  overrides 

//  { {AEX_yiKrUAL  (CPasswordDlg) 

protected: 

virtual  void  DoDataExchange  (CDataEJcchange*  pEK) ;  //  IXK/IXiV  support 

//}}MX_VIKrOAL 

//  Inplementation 
protected: 


//  Generated  nessage  functicns 
//{ (CPasswordDlg) 

//  ISDIE:  the  ClassWizard  will  add  ineirber  functions  here 
//}}AEXjeG 
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DE):iAREJESSAGEjyiAP  { ) 


}; 


Password.cpp 

//  password. qp  :  iirplenentaticn  file 

// 

#include  "stdafx.h" 

#include  "gnd.h" 

#include  "password. h" 


#ifdef  JDEBUG 
#undef  THIS_E]IE 

static  char  BASEDJDOE  ■IHIS_FH£:[]  =  FILE  ; 

#endif 

///////////////////////////////////////////////////////////////////////////// 

//  CPasswordDlg  dialog 


CPasswordDlg:  :CPasswordDlg(OWbd*  pParent  /*=OTX*/) 

:  CDialog(CPasswordDlg:  :IDD,  pPaient) 

{ 

//  { { AFXJ^mjMT  (CPasswordDlg) 

//  NCflE:  the  ClassWizard  will  add  msrber  initialization  here 
//}}AFXJDMA_m[T 

} 


void  CPasswordDlg:  :DoDataExchange(CDataExchange*  pEK) 

{ 

CDialog:  iDoCataEKChange  (pEK)  ; 

//{ {i^JD?muyiAP  (CPasswordDlg) 

//  NOTE:  the  ClassWizard  will  add  IXK  and  IXV  raJls  here 

//} 

} 


BEGIN _MESSAffi (CPasswordDlg,  ClUalog) 

//{ {AFX_MSG_MAP  {(3>asswordDlg) 

//  NOTE:  the  ClassWizard  will  add  message  map  macros  here 

ELC)jyESSftGEjyiAP() 
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iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiim 

1 1  CPasshordDlg  message  handlers 


PrefDlg.h 

//  prefdlg.h  :  header  file 

// 

///////////////////////////////////////////////////////////////////////////// 

//  CPrefDlg  dialog 

class  CPrefDlg  :  public  CDialog 

{ 

//  Ccr^tructicn 
public: 

CPrefDlg  (CWnd*  pParent  =  NUIL);  //  standard  constructor 

//  Dialog  Data 

struct  P^araTEllelnfo  (*pOldPFI)  [MRXDIPS] ,  NewPET  [MSXDIPS]  ; 

BOCaii  rrUcHasChanged/ 

//{ {MX_DAIA(CP]:efDlg) 

enum  {  in)  =  IIX)_EREEERE1CES  }  ; 

//  NOTE:  the  ClassWizard  will  add  data  mrbers  here 

//}}aexj:kia 


//  Overrides 

//  ClassWizard  generated  virtual  function  overrides 

//{ {AHX_VIRrCHL  (CPrefDlg) 

protected: 

virtual  void  DoDataExchange  (CDataExchange*  pEK) ;  //  nK/DDV  s\:pport 

//  Inplenentaticn 
protected: 


//  Generated  nessage  map  function 
//{ {MXJEG  (CPrefDlg) 
virtual  BCQL  OiInitDialogO ; 
afxjnsg  void  CnChangeFditQ  ; 
virtual  void  CnCKO  ; 

//}}SPX_MSG 
DEXXRE^JdESSMJ®^  ( ) 
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PrefDlg.cpp 

//  prefdlg.cpp  :  iirplernentatioQ  file 

// 

iinclude  "stdafe.h" 

#include  "gnd.h" 
ttindude  "prefdlg.h" 

#ifdef  _EEBUG 
todef  TE[S_FILE 

static  char  BASED_CO[E  THISJElIEf]  =  _FILE_; 

#endif 

///////////////////////////////////////////////////////////////////////////// 

//  CPrefDlg  dialog 


CPrefDlg: : CPrefDlg  {CWnd*  pParent  /*^=M}LL*/) 

:  cnialog  (CPrefDlg:  :I1X),  pParent) 

{ 

//{ (CPrefoig) 

//  NDTE:  the  ClassWizard  vdll  add  inerrber  initialization  here 
//}}AEXJDAm_INIT 

} 


void  CPrefDlg:  :DoDataExchange{CDataExchange*  pEK) 

{ 

CDialog:  iDoDataExchange  (pIK)  ; 

//{ {AEXjsaa_MAP  (CPrefDlg) 

//  JDIE:  the  ClassWizard  will  add  DEK  and  DW  calls  here 
//}>AEX_EftTA_MaP 

} 


CDialog) 

//  { {AEXjyiSGJ®P  (CPrefDlg) 
CNJKj™ra(ID:_EDITl,  CnChangeEdit) 
CNJNj:iCTO(IDC_EDI^  QnChangeEdit) 
CN_ENJ3TOE(IDCJDIT3,  CnChangeEdit) 
aJJNj2C3ra(IDCJI)CT^  CnChangeEdit) 
CNJNJ3C^(IDCJDm  QnChangeBdit) 
CnChangeEdit) 
aJ_ENJEHZaSJa:{IDC_EDIT7,  QnChangeBdit) 
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//}}AD(_MSG_M?\P 

EM5_MESSAGE_MAP{) 


///////////////////////////////////////////////////////////////////////////// 

//  CPrefDlg  iressage  handlers 


BCQL  CPrefDlg:  :aiCnitDialog() 

{ 

CDialog : :  ChlnitDialog  ( )  ; 


int  i; 

CEdit  *pEdit; 

for  (i=0;  i<y™)IRS;  1++) 

{ 

pBdit  =  (CEdit  *)GetDlgItetn(prefID[i]); 
pBdit~>SemiixicWre}rt;  ( (^pOldPFI)  [i]  .Dir)  ; 

} 


} 


ir^tHasChanged  =  FPiLSE; 

return  TPiE;  //  return  TPDE  unless  you  set  the  focus  to  a  cmtrol 
//  EXCEPTICN:  OCX  PrqDerty  Pages  should  return  EALSE 


void  CPrefDlg:  :QnChangeEdit() 

{ 

mJdHasChanged  =  TRUE; 

} 


void  CPrefDlg ; :  QnCK  ( ) 

{ 

int  i; 

CEdit  *pBdit; 


for  (i=0;  i<^®XDIRS;  i++) 

{ 

pBdit  =  (CEdit  *)GetDlgItQii(prefID[i] )  ; 
pBdit->GetWirK3cWrext  (NewPFI  [i] .  Dir) ; 

} 


} 


CDialog:  :QnCK(); 
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